regulatory-reporting
installsforks
How to install regulatory-reporting?
agiprolabs/claude-trading-skills/regulatory-reporting
$npx -y skills add agiprolabs/claude-trading-skills --skill regulatory-reporting[STUB] Regulatory report generation including IRS Form 8949, Schedule D, FinCEN FBAR, and state-specific crypto reporting requirements
SKILL.md
| 1 | # Regulatory Reporting |
| 2 | |
| 3 | > **STATUS: STUB** — This skill outlines planned capabilities for crypto tax and regulatory reporting. All generated output must be reviewed by a qualified tax professional before filing. Nothing in this skill constitutes tax or legal advice. |
| 4 | |
| 5 | ## Overview |
| 6 | |
| 7 | Track and generate required regulatory reports for cryptocurrency trading activity. Covers U.S. federal forms (IRS Form 8949, Schedule D), FinCEN foreign account reporting (FBAR), state-specific crypto obligations, large-transaction flagging, and deadline tracking. |
| 8 | |
| 9 | Crypto tax reporting is complex and evolving. Rules change frequently, cost-basis methods vary by jurisdiction, and DeFi activities (swaps, LP positions, airdrops, staking rewards) have ambiguous treatment under current guidance. This skill provides a structured framework for organizing trade data into the formats regulators expect — but a tax professional must validate every filing. |
| 10 | |
| 11 | ## Disclaimer |
| 12 | |
| 13 | > **WARNING**: This skill is for informational and educational purposes only. It does NOT constitute tax, legal, or financial advice. Cryptocurrency tax law is complex, jurisdiction-specific, and rapidly evolving. You MUST consult a qualified tax professional (CPA, EA, or tax attorney with crypto expertise) before relying on any output from this skill for actual tax filings. Errors in tax reporting can result in penalties, interest, and legal consequences. The authors accept no liability for any use of this material. |
| 14 | |
| 15 | ## Current Status |
| 16 | |
| 17 | This is a **STUB** skill. The code and references provided are starting points that demonstrate data structures and basic calculations. They have NOT been validated against current IRS guidance or any state tax authority requirements. |
| 18 | |
| 19 | ### What Exists Now |
| 20 | |
| 21 | - Basic Form 8949 line-item generation from trade data (see `scripts/form_8949_generator.py`) |
| 22 | - Regulatory requirements overview (see `references/planned_features.md`) |
| 23 | - Demo mode with sample trade data |
| 24 | |
| 25 | ### What Is Planned |
| 26 | |
| 27 | - Complete IRS Form 8949 and Schedule D PDF generation |
| 28 | - FinCEN FBAR generation when foreign exchange accounts exceed $10,000 |
| 29 | - State-specific reporting requirement detection and templates |
| 30 | - Reporting threshold tracking and deadline calendar |
| 31 | - Large transaction flagging ($10,000+ cash-equivalent transactions) |
| 32 | - Foreign account reporting requirements (FATCA Form 8938) |
| 33 | - Wash sale detection and adjustment (where applicable) |
| 34 | - Cost-basis method selection (FIFO, LIFO, Specific ID, HIFO) |
| 35 | - DeFi-specific event classification (swaps, LP entry/exit, staking, airdrops) |
| 36 | - Actual IRS-compatible CSV/PDF form data output |
| 37 | |
| 38 | ## Prerequisites |
| 39 | |
| 40 | ```bash |
| 41 | # No external dependencies for the demo script |
| 42 | python scripts/form_8949_generator.py --demo |
| 43 | ``` |
| 44 | |
| 45 | For a production implementation, the following would be needed: |
| 46 | |
| 47 | ```bash |
| 48 | uv pip install pandas reportlab # PDF generation |
| 49 | ``` |
| 50 | |
| 51 | ## Key Concepts |
| 52 | |
| 53 | ### IRS Form 8949 — Sales and Dispositions of Capital Assets |
| 54 | |
| 55 | Form 8949 reports each individual sale or disposition of a capital asset. For crypto, every trade, swap, or spending event is a taxable disposition. Key fields: |
| 56 | |
| 57 | | Column | Description | |
| 58 | |--------|-------------| |
| 59 | | (a) | Description of property (e.g., "2.5 BTC") | |
| 60 | | (b) | Date acquired | |
| 61 | | (c) | Date sold or disposed of | |
| 62 | | (d) | Proceeds (sale price in USD) | |
| 63 | | (e) | Cost or other basis | |
| 64 | | (f) | Adjustment code (e.g., W for wash sale) | |
| 65 | | (g) | Adjustment amount | |
| 66 | | (h) | Gain or loss (d minus e, adjusted by g) | |
| 67 | |
| 68 | Transactions are split into **Part I** (short-term, held one year or less) and **Part II** (long-term, held more than one year). |
| 69 | |
| 70 | ### Schedule D — Capital Gains and Losses |
| 71 | |
| 72 | Schedule D aggregates the totals from Form 8949: |
| 73 | - Line 1b/8b: Totals from Form 8949 Part I / Part II (basis reported to IRS) |
| 74 | - Line 1c/8c: Totals where basis was NOT reported to IRS |
| 75 | - Line 7/15: Net short-term / long-term capital gain or loss |
| 76 | - Line 16: Combined net gain or loss |
| 77 | |
| 78 | ### FinCEN FBAR (FinCEN Form 114) |
| 79 | |
| 80 | Required when the aggregate value of foreign financial accounts exceeds $10,000 at any point during the calendar year. Crypto held on foreign exchanges (e.g., Binance for non-U.S. entities) may trigger this requirement — though IRS guidance on whether crypto accounts are "foreign financial accounts" remains evolving. |
| 81 | |
| 82 | - **Filing deadline**: April 15 (automatic extension to October 15) |
| 83 | - **Penalty for non-filing**: Up to $12,500 per non-willful violation; up to $100,000 or 50% of account balance for willful violations |
| 84 | |
| 85 | ### Large Transaction Reporting |
| 86 | |
| 87 | Businesses receiving $10,000+ in cash (which may include crypto under recent guidance) must file IRS Form 8300 within 15 days. Individual traders generally do not file Form 8300, but exchanges may report large transactions. |
| 88 | |
| 89 | ## Quick Start |
| 90 | |
| 91 | ``` |
People who liked this also viewed
6 picksType
- azure-costAzure cost management: query costs, forecast spending, optimize to reduce waste. WHEN: \"Azure costs\", \"Azure bill\", \"cost breakdown\", \"how much am I spending\", \"forecast spending\", \"optimizSkillsJul 2026
- pricingWhen the user wants help with pricing decisions, packaging, or monetization strategy. Also use when the user mentions 'pricing,' 'pricing tiers,' 'freemium,' 'free trial,' 'packaging,' 'price increaseSkillsJul 2026
- stripe-integrationMulti-harness agentic plugin marketplace for Claude Code, Codex CLI, Cursor, OpenCode, GitHub Copilot, and Gemini CLISkillsJul 2026
- startup-financial-modelingMulti-harness agentic plugin marketplace for Claude Code, Codex CLI, Cursor, OpenCode, GitHub Copilot, and Gemini CLISkillsJul 2026
- tushare-finance专为 Claude Code 设计的 Tushare Pro 金融数据技能包，支持 220+ 个接口，用自然语言获取 A 股行情、财务数据、宏观经济等金融数据。SkillsJul 2026
- azure-pricingFetches real-time Azure retail pricing using the Azure Retail Prices API (prices.azure.com) and estimates Copilot Studio agent credit consumption. Use when the user asks about the cost of any Azure seSkillsJul 2026
