Agent skill

Regulatory Reporting

by agiprolabs in agiprolabs/claude-trading-skills

[STUB] Regulatory report generation including IRS Form 8949, Schedule D, FinCEN FBAR, and state-specific crypto reporting requirements

MITAuto-check passedBusiness, Finance & HR

Install Regulatory Reporting

skills CLI
$ npx skills add agiprolabs/claude-trading-skills --skill regulatory-reporting -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install agiprolabs/claude-trading-skills regulatory-reporting --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/agiprolabs/claude-trading-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/regulatory-reporting .claude/skills/regulatory-reporting && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
regulatory-reporting
GitHub stars
410
Token cost
~2.3k tokens
SKILL.md length
1,012 words
Files
3 (incl. scripts, references)
Skills in repo
68
Repo updated
First seen
Licence
MIT

At a glance

[STUB] Regulatory report generation including IRS Form 8949, Schedule D, FinCEN FBAR, and state-specific crypto reporting requirements

  • Works in 5 steps: End-of-year tax preparation — Export… → Quarterly estimated tax tracking —… → FBAR threshold monitoring — Track… → …
  • Tasks that involve Regulatory compliance
  • SKILL.md covers Overview, Disclaimer, Current Status and Prerequisites, plus 8 more sections
  • Runs Python scripts from its folder; calls python and uv

What it does

Regulatory Reporting is an agent skill from agiprolabs/claude-trading-skills. [STUB] Regulatory report generation including IRS Form 8949, Schedule D, FinCEN FBAR, and state-specific crypto reporting requirements

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts and reference files (for example `references/planned_features.md` and `scripts/form_8949_generator.py`).

It sits in Business, Finance & HR, covering Regulatory compliance and Crypto and DeFi analysis. The repository describes itself as: 68 trading, DeFi, and quantitative finance Agent Skills. Works with Claude Code, Cursor, Codex, Gemini CLI, and 30+ other tools. The licence is MIT.

When your agent uses it

  • Tasks that involve Regulatory compliance
  • Tasks that involve Crypto and DeFi analysis

Example prompts

  • “/regulatory-reporting”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. End-of-year tax preparation — Export trade history from exchanges, generate Form 8949 line items, calculate Schedule D totals, and hand…
  2. Quarterly estimated tax tracking — Monitor cumulative realized gains throughout the year to estimate quarterly tax payments (IRS Form…
  3. FBAR threshold monitoring — Track aggregate balances across foreign exchange accounts to determine whether FBAR filing is required.
  4. Audit preparation — Maintain organized records of all dispositions with cost-basis documentation in case of an IRS inquiry.
  5. Multi-state filing — Identify state-specific crypto reporting obligations when trading from states with additional requirements.

What it can do on your machine

Read from SKILL.md and the folder at commit 981e1d7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Regulatory Reporting loads about 2.3k tokens when it runs, and up to ~4.3k if it reads all its reference files. Until then it costs about 39 tokens; SKILL.md has 1,012 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from agiprolabs/claude-trading-skills at commit 981e1d7, republished under its MIT licence (© agiprolabs). 1,012 words, ~2,278 tokens.

Download SKILL.mdSave it as .claude/skills/regulatory-reporting/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
regulatory-reporting
description
[STUB] Regulatory report generation including IRS Form 8949, Schedule D, FinCEN FBAR, and state-specific crypto reporting requirements
license
MIT
metadata.author
agipro
metadata.version
0.1.0
metadata.category
trading

Regulatory Reporting

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.

Overview

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.

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.

Disclaimer

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.

Current Status

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.

What Exists Now
  • Basic Form 8949 line-item generation from trade data (see scripts/form_8949_generator.py)
  • Regulatory requirements overview (see references/planned_features.md)
  • Demo mode with sample trade data
What Is Planned
  • Complete IRS Form 8949 and Schedule D PDF generation
  • FinCEN FBAR generation when foreign exchange accounts exceed $10,000
  • State-specific reporting requirement detection and templates
  • Reporting threshold tracking and deadline calendar
  • Large transaction flagging ($10,000+ cash-equivalent transactions)
  • Foreign account reporting requirements (FATCA Form 8938)
  • Wash sale detection and adjustment (where applicable)
  • Cost-basis method selection (FIFO, LIFO, Specific ID, HIFO)
  • DeFi-specific event classification (swaps, LP entry/exit, staking, airdrops)
  • Actual IRS-compatible CSV/PDF form data output

Prerequisites

bash
# No external dependencies for the demo script
python scripts/form_8949_generator.py --demo

For a production implementation, the following would be needed:

bash
uv pip install pandas reportlab  # PDF generation

Key Concepts

IRS Form 8949 — Sales and Dispositions of Capital Assets

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:

ColumnDescription
(a)Description of property (e.g., "2.5 BTC")
(b)Date acquired
(c)Date sold or disposed of
(d)Proceeds (sale price in USD)
(e)Cost or other basis
(f)Adjustment code (e.g., W for wash sale)
(g)Adjustment amount
(h)Gain or loss (d minus e, adjusted by g)

Transactions are split into Part I (short-term, held one year or less) and Part II (long-term, held more than one year).

Schedule D — Capital Gains and Losses

Schedule D aggregates the totals from Form 8949:

  • Line 1b/8b: Totals from Form 8949 Part I / Part II (basis reported to IRS)
  • Line 1c/8c: Totals where basis was NOT reported to IRS
  • Line 7/15: Net short-term / long-term capital gain or loss
  • Line 16: Combined net gain or loss
FinCEN FBAR (FinCEN Form 114)

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.

  • Filing deadline: April 15 (automatic extension to October 15)
  • Penalty for non-filing: Up to $12,500 per non-willful violation; up to $100,000 or 50% of account balance for willful violations
Show full SKILL.md (423 more words)Show less
Large Transaction Reporting

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.

Quick Start

python
"""Generate Form 8949 line items from trade history."""
from dataclasses import dataclass
from datetime import date
from decimal import Decimal

@dataclass
class Trade:
    asset: str
    quantity: Decimal
    date_acquired: date
    date_sold: date
    proceeds_usd: Decimal
    cost_basis_usd: Decimal

def classify_holding_period(trade: Trade) -> str:
    """Return 'short-term' or 'long-term' based on holding period."""
    holding_days = (trade.date_sold - trade.date_acquired).days
    return "short-term" if holding_days <= 365 else "long-term"

def compute_gain_loss(trade: Trade) -> Decimal:
    """Compute capital gain or loss for a single trade."""
    return trade.proceeds_usd - trade.cost_basis_usd

# Example
trade = Trade(
    asset="SOL",
    quantity=Decimal("10"),
    date_acquired=date(2025, 1, 15),
    date_sold=date(2025, 8, 20),
    proceeds_usd=Decimal("2500.00"),
    cost_basis_usd=Decimal("1800.00"),
)
gain = compute_gain_loss(trade)
period = classify_holding_period(trade)
print(f"{trade.asset}: {period} gain of ${gain}")
# SOL: short-term gain of $700.00

Use Cases

  1. End-of-year tax preparation — Export trade history from exchanges, generate Form 8949 line items, calculate Schedule D totals, and hand the organized data to your tax professional.

  2. Quarterly estimated tax tracking — Monitor cumulative realized gains throughout the year to estimate quarterly tax payments (IRS Form 1040-ES).

  3. FBAR threshold monitoring — Track aggregate balances across foreign exchange accounts to determine whether FBAR filing is required.

  4. Audit preparation — Maintain organized records of all dispositions with cost-basis documentation in case of an IRS inquiry.

  5. Multi-state filing — Identify state-specific crypto reporting obligations when trading from states with additional requirements.

Files

References
  • references/planned_features.md — Regulatory requirements overview, Form 8949/Schedule D field descriptions, FBAR thresholds, state requirements summary, and reporting deadlines
Scripts
  • scripts/form_8949_generator.py — Basic Form 8949 line-item generator from trade data with --demo mode; no external dependencies

Limitations

  • Not legal or tax advice. This is a software tool, not a tax professional.
  • U.S.-focused. International tax obligations are not covered.
  • Evolving rules. Crypto tax guidance changes frequently; this skill may not reflect the latest IRS notices or rulings.
  • No DeFi classification yet. Complex DeFi events (LP positions, yield farming, rebasing tokens) are not yet handled.
  • No wash sale certainty. Whether wash sale rules apply to crypto is unsettled; the skill flags potential wash sales but cannot make definitive determinations.
  • Cost-basis methods limited. Only FIFO is implemented in the demo; LIFO, HIFO, and Specific ID are planned.

Reporting Deadlines (U.S. Federal)

FormDeadlineExtension
Form 8949 / Schedule DApril 15October 15 (with Form 4868)
FinCEN FBAR (Form 114)April 15October 15 (automatic)
Form 830015 days after transactionNone
FATCA Form 8938With tax returnWith tax return extension
1040-ES (quarterly)Apr 15, Jun 15, Sep 15, Jan 15None

Contributing

This is a stub skill with significant room for expansion. Contributions welcome in these areas:

  • Additional cost-basis methods (LIFO, HIFO, Specific ID)
  • DeFi event classification (LP entry/exit, staking, airdrops, bridging)
  • State-specific requirement databases
  • Wash sale detection algorithms
  • PDF form generation (IRS-compatible output)
  • International tax jurisdiction support
  • Integration with exchange API export formats

All contributions must include appropriate disclaimers and must not provide specific tax advice. See the project CLAUDE.md for contribution guidelines.

  • portfolio-analytics — Portfolio performance tracking that feeds into tax reporting
  • trade-journal — Trade logging that can serve as source data for Form 8949

© agiprolabs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts, references) in skills/regulatory-reporting of agiprolabs/claude-trading-skills.

  • SKILL.md
  • references/planned_features.md
  • scripts/form_8949_generator.py

Open the folder on GitHubat commit 981e1d7

Compare with similar skills

Regulatory Reporting next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Regulatory Reporting compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Regulatory Reporting this skillagiprolabs/claude-trading-skills410—~2.3kAutomated safety check: PassMIT
Mortgage Compliancedavepoon/buildwithclaude3.6k—~448Automated safety check: PassMIT
Rfp Response Compliance Reviewpnp/sharepoint-skills133—~2.8kAutomated safety check: PassMIT
Sealeap Fenghuang Amazon Product Research Methodsxjli360/sealeap-amazon-skills251—~725Automated safety check: PassMIT
Technical Analysttradermonty/claude-trading-skills3k4 repos~4.6kAutomated safety check: PassMIT
Polyclawchainstacklabs/polyclaw3591 repos~2kAutomated safety check: PassApache-2.0

Similar skills

  • Mortgage Compliance

    davepoon/buildwithclaude

    Enforces mortgage regulatory compliance — TRID, RESPA, TILA, ECOA/Fair Lending, state licensing, required disclosures, and data privacy rules for all borrower interactions.

    3.6k GitHub stars~448 tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Rfp Response Compliance Review

    pnp/sharepoint-skills

    Reviews a draft proposal against the firm's configurable compliance rules — prohibited language, required disclosures, role and positioning boundaries, and procurement-submission requirements.

    133 GitHub stars~2.8k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Generate product candidates for the US marketplace through several discovery paths—keyword-gap search, filtered product databases, reverse-ASIN keyword pulls, and own-problem ideas—then push every…

    251 GitHub stars~725 tokensUpdated 12 days ago
    Business, Finance & HRAuto-check passed
  • Technical Analyst

    tradermonty/claude-trading-skills

    This skill should be used when analyzing weekly price charts for stocks, stock indices, cryptocurrencies, or forex pairs.

    3k GitHub starsUsed in 4 repos~4.6k tokens
    Business, Finance & HRAuto-check passed
  • Polyclaw

    chainstacklabs/polyclaw

    Trade on Polymarket via split + CLOB execution. An agent skill from chainstacklabs/polyclaw.

    359 GitHub starsUsed in 1 repo~2k tokens
    Business, Finance & HRAuto-check passed
  • Longbridge Research

    helsome/folio

    Institution ratings, consensus price targets, EPS/revenue forecasts, finance calendar, shareholder data, fund holders, insider trades (SEC Form 4), short interest, industry rankings, peer group…

    271 GitHub starsUsed in 3 repos~2.1k tokens
    Business, Finance & HRAuto-check passed

More from agiprolabs/claude-trading-skills

All 68 skills in this repo
  • Backtrader

    agiprolabs/claude-trading-skills

    Event-driven backtesting with bar-by-bar execution, complex order types, multiple analyzers, and custom indicators

    410 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Birdeye API

    agiprolabs/claude-trading-skills

    Solana token market data via Birdeye — prices, OHLCV, trades, token metadata, security checks, and trader activity

    410 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Coingecko API

    agiprolabs/claude-trading-skills

    Broad crypto market data from CoinGecko covering 13,000+ tokens.

    410 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Cointegration Analysis

    agiprolabs/claude-trading-skills

    Cointegration testing for pairs trading using Engle-Granger, Johansen, and rolling stability analysis

    410 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Copy Trading

    agiprolabs/claude-trading-skills

    Wallet evaluation, monitoring, and copy-trade strategy design for Solana DEX trading

    410 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Correlation Analysis

    agiprolabs/claude-trading-skills

    Cross-asset correlation analysis including rolling correlation, hierarchical clustering, tail dependence, and regime-dependent correlation

    410 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Regulatory Reporting

What does Regulatory Reporting do?

[STUB] Regulatory report generation including IRS Form 8949, Schedule D, FinCEN FBAR, and state-specific crypto reporting requirements. Regulatory Reporting is an agent skill from agiprolabs/claude-trading-skills.

When should I use Regulatory Reporting?

Regulatory Reporting fits situations like: tasks that involve Regulatory compliance; tasks that involve Crypto and DeFi analysis.

How do I install Regulatory Reporting in Claude Code?

Run `npx skills add agiprolabs/claude-trading-skills --skill regulatory-reporting -a claude-code`. Or copy the skill folder (skills/regulatory-reporting in agiprolabs/claude-trading-skills) into .claude/skills/regulatory-reporting in your project. Claude Code loads it when a task matches its description.

How do I install Regulatory Reporting in Codex?

Run `npx skills add agiprolabs/claude-trading-skills --skill regulatory-reporting -a codex`. Or copy the skill folder (skills/regulatory-reporting in agiprolabs/claude-trading-skills) into .agents/skills/regulatory-reporting in your project. Codex loads it when a task matches its description.

Can I use Regulatory Reporting in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add agiprolabs/claude-trading-skills --skill regulatory-reporting -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/regulatory-reporting, .gemini/skills/regulatory-reporting, .github/skills/regulatory-reporting and .opencode/skills/regulatory-reporting in your project.

What does Regulatory Reporting need to run?

Going by SKILL.md and its folder, Regulatory Reporting needs Python for the scripts in its folder and the command-line tools its instructions call (python and uv). Our summary lists: Python 3.

Does Regulatory Reporting access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Regulatory Reporting safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Regulatory Reporting use?

Regulatory Reporting is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Regulatory Reporting use?

About 2.3k tokens (SKILL.md is roughly 9.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2k tokens, read only when the agent opens those files.

What are the alternatives to Regulatory Reporting?

Skills that share tags, products or a category with Regulatory Reporting: Mortgage Compliance (davepoon/buildwithclaude, 3.6k stars), Rfp Response Compliance Review (pnp/sharepoint-skills, 133 stars), Sealeap Fenghuang Amazon Product Research Methods (xjli360/sealeap-amazon-skills, 251 stars) and Technical Analyst (tradermonty/claude-trading-skills, 3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Regulatory Reporting?

agiprolabs (a GitHub user) maintains it in agiprolabs/claude-trading-skills, which has 410 GitHub stars. The repository holds 68 skills in this directory. The repository was last updated on September 3, 2026.

Source: agiprolabs/claude-trading-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.