Fangyi-Chen/SuperTaxAgent

tax-fill

Fill official IRS Form 1040 PDF with calculated tax data and export a mail-ready PDF. Use when the user wants to generate, fill, or export their tax return.

tax-publish

Create a git branch, stage only skill and reference files, commit, push, and open a GitHub PR with anonymized evidence. Use after tax-evolve applies fixes, or when contributing manual improvements.

tax-evolve

Analyze comparison diffs, classify discrepancies, and generate fixes to skill files and references. Logs patterns to evolution-log.json and invokes tax-publish when fixes are ready. Use after running tax-compare.

tax-compare

Diff two tax return PDFs (ours vs TurboTax or other reference). Extracts field values from both PDFs, compares them line by line against Form 1040 field mapping, and saves a structured diff to data/comparison-{year}.json. Use when the user wants to verify…

tax-domain-crypto

Digital asset and cryptocurrency tax rules. Invoked by core skills when a 1099-DA is detected during document import or when the user reports cryptocurrency transactions.

tax-domain-harvest

Tax-loss harvesting and wash sale tax rules. Invoked by core skills when 1099-B contains wash sale adjustments or when unrealized losses are detected in the portfolio.

tax-domain-rental

Rental property and Schedule E tax rules. Invoked by core skills when the user reports rental income or ownership of income-producing real property.

tax-domain-rsu

RSU and ESPP income tax rules. Invoked by core skills when W2 box 14 contains RSU codes, 1099-B contains ESPP/RSU lots, or user mentions stock compensation during interview.

tax-start

Start the interactive tax filing process. Use when the user wants to begin filing taxes, start a tax return, or says "do my taxes".

tax-import

Import tax documents like W2 PDFs, 1099s, or brokerage statements. Use when the user wants to import, upload, or parse a tax document.

tax-calculate

Calculate federal tax return based on collected data. Use when the user wants to calculate taxes, see their refund, or compute what they owe.