{"id":"8f9af5f3-b2ef-44f4-b6f7-4b27a0200c68","entityType":"agent","slug":"clawhub-bytesagain-lab-crypto-tax-calc","name":"Crypto Tax Calc","canonicalUrl":"https://www.xpersona.co/agent/clawhub-bytesagain-lab-crypto-tax-calc","canonicalPath":"/agent/clawhub-bytesagain-lab-crypto-tax-calc","generatedAt":"2026-10-10T14:44:19.397Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T12:40:47.800Z","emptyReason":null},"description":"Cryptocurrency tax reference — IRS guidance, FIFO/LIFO/HIFO cost basis methods, Form 8949, tax loss harvesting, and DeFi transaction categorization Skill: Crypto Tax Calc Owner: bytesagain-lab Summary: Cryptocurrency tax reference — IRS guidance, FIFO/LIFO/HIFO cost basis methods, Form 8949, tax loss harvesting, and DeFi transaction categorization Tags: chinese:1.0.0, latest:3.0.0, productivity:1.0.1 Version history: v3.0.0 | 2026-03-23T00:46:18.671Z | user Clean package with matching SKILL.md and script v2.0.1 | 2026-03-18T10:40:05.279Z | user update v2.0.0 | 2","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.4K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s174pq5f3gzez3838vt2642fmx848f1d:crypto-tax-calc","sourceUrl":"https://clawhub.ai/bytesagain-lab/crypto-tax-calc","homepage":"https://clawhub.ai/bytesagain-lab/skills/crypto-tax-calc","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/bytesagain-lab/crypto-tax-calc","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/bytesagain-lab/skills/crypto-tax-calc","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":63,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Cryptocurrency tax reference — IRS guidance, FIFO/LIFO/HIFO cost basis methods, Form 8949, tax loss harvesting, and DeFi transaction categorization Skill: Crypt"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T12:40:47.800Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T12:40:47.800Z","emptyReason":null},"stars":null,"forks":null,"downloads":1430,"packageName":null,"latestVersion":"3.0.0","tractionLabel":"1.4K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T12:40:47.800Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T12:40:47.800Z","lastCrawledAt":"2026-10-10T12:40:47.800Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T12:40:47.800Z","lastVerifiedAt":null,"highlights":[{"version":"3.0.0","createdAt":"2026-03-23T00:46:18.671Z","changelog":"Clean package with matching SKILL.md and script","fileCount":4,"zipByteSize":8686},{"version":"2.0.1","createdAt":"2026-03-18T10:40:05.279Z","changelog":"update","fileCount":5,"zipByteSize":10428},{"version":"2.0.0","createdAt":"2026-03-17T18:51:34.042Z","changelog":"v2.5 standard: Use-when desc, homepage, source, security fix","fileCount":5,"zipByteSize":10495},{"version":"2.4.5","createdAt":"2026-03-16T12:52:39.740Z","changelog":"yaml-fix+quality","fileCount":5,"zipByteSize":10509},{"version":"2.4.4","createdAt":"2026-03-16T11:58:13.322Z","changelog":"yaml-fix+quality","fileCount":5,"zipByteSize":10508},{"version":"2.4.3","createdAt":"2026-03-15T21:41:19.664Z","changelog":"Quality upgrade: custom functionality","fileCount":4,"zipByteSize":9374},{"version":"2.4.2","createdAt":"2026-03-15T12:44:49.131Z","changelog":"Standards compliance: unique content, no template text","fileCount":4,"zipByteSize":9374},{"version":"2.4.1","createdAt":"2026-03-15T01:04:16.858Z","changelog":"Quality improvement: better docs, examples, cleaner text","fileCount":4,"zipByteSize":9375}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s174pq5f3gzez3838vt2642fmx848f1d:crypto-tax-calc","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-crypto-tax-calc/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-crypto-tax-calc/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-crypto-tax-calc/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-crypto-tax-calc/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-crypto-tax-calc/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-crypto-tax-calc/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T14:44:19.396Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-crypto-tax-calc/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-crypto-tax-calc/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-crypto-tax-calc/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-crypto-tax-calc/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T12:40:47.800Z","emptyReason":null},"readme":"Skill: Crypto Tax Calc\n\nOwner: bytesagain-lab\n\nSummary: Cryptocurrency tax reference — IRS guidance, FIFO/LIFO/HIFO cost basis methods, Form 8949, tax loss harvesting, and DeFi transaction categorization\n\nTags: chinese:1.0.0, latest:3.0.0, productivity:1.0.1\n\nVersion history:\n\nv3.0.0 | 2026-03-23T00:46:18.671Z | user\n\nClean package with matching SKILL.md and script\n\nv2.0.1 | 2026-03-18T10:40:05.279Z | user\n\nupdate\n\nv2.0.0 | 2026-03-17T18:51:34.042Z | user\n\nv2.5 standard: Use-when desc, homepage, source, security fix\n\nv2.4.5 | 2026-03-16T12:52:39.740Z | user\n\nyaml-fix+quality\n\nv2.4.4 | 2026-03-16T11:58:13.322Z | user\n\nyaml-fix+quality\n\nv2.4.3 | 2026-03-15T21:41:19.664Z | user\n\nQuality upgrade: custom functionality\n\nv2.4.2 | 2026-03-15T12:44:49.131Z | user\n\nStandards compliance: unique content, no template text\n\nv2.4.1 | 2026-03-15T01:04:16.858Z | user\n\nQuality improvement: better docs, examples, cleaner text\n\nv2.4.0 | 2026-03-14T01:39:19.564Z | user\n\nFixed: aligned documentation with implementation, added missing commands\n\nv2.3.0 | 2026-03-14T00:19:12.503Z | user\n\nQuality fixes: removed third-party references, aligned docs with implementation\n\nv2.2.0 | 2026-03-13T16:58:50.857Z | user\n\nEnhanced descriptions for better AI triggering\n\nv1.0.2 | 2026-03-13T00:16:59.939Z | user\n\nRuntime fix\n\nv1.0.1 | 2026-03-12T02:29:47.410Z | auto\n\n- Removed the file tips.md.\n- No changes to functionality or documentation other than this removal.\n\nv1.0.0 | 2026-03-11T09:18:01.851Z | auto\n\n- Initial release of Crypto Tax Calculator.\n- Supports FIFO, LIFO, and average cost basis methods.\n- Provides multi-country tax law support (US, UK, Australia, China).\n- Imports trades via CSV, validates and normalizes data, and generates professional HTML, CSV, and JSON tax reports.\n- Includes command-line tools for calculation, validation, merging, and comparing methods.\n- Outputs jurisdiction-specific report formats and summaries.\n\nArchive index:\n\nArchive v3.0.0: 4 files, 8686 bytes\n\nFiles: scripts/script.sh (15177b), skill-card.md (2088b), SKILL.md (1420b), _meta.json (134b)\n\nFile v3.0.0:SKILL.md\n\n---\nname: \"crypto-tax-calc\"\nversion: \"3.0.0\"\ndescription: \"Cryptocurrency tax reference — IRS guidance, FIFO/LIFO/HIFO cost basis methods, Form 8949, tax loss harvesting, and DeFi transaction categorization\"\nauthor: \"BytesAgain\"\nhomepage: \"https://bytesagain.com\"\nsource: \"https://github.com/bytesagain/ai-skills\"\ntags: [crypto-tax, irs, capital-gains, form-8949, defi]\ncategory: \"blockchain\"\n---\n\n# Crypto Tax Calc\n\nCryptocurrency tax reference — IRS guidance, FIFO/LIFO/HIFO cost basis methods, Form 8949, tax loss harvesting, and DeFi transaction categorization. No API keys or credentials required — outputs reference documentation only.\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `intro` | Taxable events, tax categories, IRS guidance |\n| `standards` | Cost basis methods, Form 8949, reporting |\n| `troubleshooting` | Missing basis, DeFi categorization, wash sales |\n| `performance` | Tax loss harvesting, donation strategy |\n| `security` | Record-keeping, audit preparation, FBAR |\n| `migration` | Spreadsheet to tax software, exchange exports |\n| `cheatsheet` | Tax brackets, form fields, key dates |\n| `faq` | Reporting requirements, gas fees, IRS tracking |\n\n## Output Format\n\nAll commands output plain-text reference documentation via heredoc. No external API calls, no credentials needed, no network access.\n\n---\n\n*Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*\n\nFile v3.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"crypto-tax-calc\",\n  \"version\": \"3.0.0\",\n  \"publishedAt\": 1774226778671\n}\n\nFile v3.0.0:skill-card.md\n\n## Description:\n\nCryptocurrency tax reference covering IRS guidance, FIFO/LIFO/HIFO cost basis methods, Form 8949, tax loss harvesting, and DeFi transaction categorization.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[bytesagain-lab](https://clawhub.ai/user/bytesagain-lab)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill as a quick reference for cryptocurrency tax concepts, reporting categories, record keeping, and migration to tax software. It is reference guidance only and should be checked against current rules for the relevant jurisdiction and tax year.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Tax guidance can become outdated or vary by jurisdiction and tax year.\n\nMitigation: Confirm the information against current official guidance for the relevant jurisdiction and tax year, or consult a qualified tax professional before filing or tax planning.\n\nRisk: Users may mistake reference documentation for personalized tax advice.\n\nMitigation: Use the skill as a quick reference only and review transaction-specific decisions with appropriate professional support.\n\n## Reference(s):\n\n- [Crypto Tax Calc on ClawHub](https://clawhub.ai/bytesagain-lab/skills/crypto-tax-calc)\n- [Publisher profile: bytesagain-lab](https://clawhub.ai/user/bytesagain-lab)\n- [BytesAgain homepage](https://bytesagain.com)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, guidance]\n\n**Output Format:** [Plain-text reference documentation with Markdown headings and tables]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [No credentials, network access, persistence, or hidden execution indicated by security evidence.]\n\n## Skill Version(s):\n\n3.0.0 (source: frontmatter and release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v2.0.1: 5 files, 10428 bytes\n\nFiles: scripts/script.sh (2512b), scripts/tax.sh (20874b), SKILL.md (4354b), tips.md (1750b), _meta.json (134b)\n\nFile v2.0.1:SKILL.md\n\n---\nversion: \"2.0.0\"\nname: Crypto Tax Calculator\ndescription: \"Calculate crypto taxes by importing trades and generating tax reports. Use when importing trades, calculating gains, generating tax reports.\"\nauthor: BytesAgain\nhomepage: https://bytesagain.com\nsource: https://github.com/bytesagain/ai-skills\n---\n# Crypto Tax Calculator\n\nA financial tracking and analysis tool for recording transactions, managing budgets, reviewing spending categories, generating summaries, and forecasting trends. Crypto Tax Calculator provides 10 focused commands for personal financial management with local data storage.\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `crypto-tax-calc track <description> <amount>` | Record a transaction with a description and amount |\n| `crypto-tax-calc balance` | Show current balance information (references local ledger) |\n| `crypto-tax-calc summary` | Display a financial summary for the current month (income vs expenses) |\n| `crypto-tax-calc export` | Export transaction data to CSV format (outputs to stdout) |\n| `crypto-tax-calc budget` | Show budget overview with category breakdown (budget, spent, remaining) |\n| `crypto-tax-calc history` | Display the 20 most recent transactions from the data log |\n| `crypto-tax-calc alert <item> <threshold>` | Set a price or budget alert for a specific item at a given threshold |\n| `crypto-tax-calc compare` | Compare the current period against the previous period |\n| `crypto-tax-calc forecast` | Generate a simple financial forecast based on current trends |\n| `crypto-tax-calc categories` | Display available spending categories (Food, Transport, Housing, Entertainment, Savings) |\n| `crypto-tax-calc help` | Display available commands and usage information |\n| `crypto-tax-calc version` | Print current version (v2.0.0) |\n\n## Data Storage\n\nAll data is stored locally in plain-text files:\n\n- **Location**: `~/.local/share/crypto-tax-calc/` (override with `CRYPTO_TAX_CALC_DIR` env var, or `XDG_DATA_HOME`)\n- **Data file**: `data.log` — main transaction ledger\n- **History log**: `history.log` — timestamped operation log for audit trail\n- **Format**: Pipe-delimited entries with timestamps\n- **No cloud sync** — everything stays on your machine, no API keys needed\n\n## Requirements\n\n- Bash 4.0+ (uses `set -euo pipefail`)\n- Standard Unix utilities: `date`, `wc`, `tail`, `cat`\n- No external dependencies, no API keys, no network access required\n- Works on Linux and macOS\n\n## When to Use\n\n1. **Transaction logging** — Record daily purchases, income, and transfers with `crypto-tax-calc track` to build a comprehensive financial history\n2. **Budget monitoring** — Use `budget` and `categories` to review spending by category and see where your money goes each month\n3. **Monthly summaries** — Run `summary` to get a quick income-vs-expenses overview for the current period without opening a spreadsheet\n4. **Period comparison** — Use `compare` to see how your current spending and income stack up against the previous period and spot trends\n5. **Data export** — Use `export` to generate CSV output that can be imported into spreadsheets, tax software, or other financial tools\n\n## Examples\n\n```bash\n# Record a transaction\ncrypto-tax-calc track \"coffee shop\" 4.50\n\n# Check your current balance\ncrypto-tax-calc balance\n\n# View monthly financial summary\ncrypto-tax-calc summary\n\n# Export all transactions to CSV (pipe to file)\ncrypto-tax-calc export > transactions.csv\n\n# Review budget breakdown by category\ncrypto-tax-calc budget\n\n# View recent transaction history\ncrypto-tax-calc history\n\n# Set a price alert\ncrypto-tax-calc alert \"BTC\" 70000\n\n# Compare current vs previous period\ncrypto-tax-calc compare\n\n# Get a simple forecast based on trends\ncrypto-tax-calc forecast\n\n# View available spending categories\ncrypto-tax-calc categories\n```\n\n## Configuration\n\nSet the `CRYPTO_TAX_CALC_DIR` environment variable to change the data directory. Alternatively, set `XDG_DATA_HOME` to relocate all XDG-compliant app data. Default location: `~/.local/share/crypto-tax-calc/`\n\n## Disclaimer\n\n⚠️ This tool is for **informational and personal tracking purposes only**. It is NOT financial or tax advice. Always consult a qualified professional for tax filing and financial decisions.\n\n---\n\n*Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*\n\nFile v2.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"crypto-tax-calc\",\n  \"version\": \"2.0.1\",\n  \"publishedAt\": 1773830405279\n}\n\nFile v2.0.1:tips.md\n\n# Crypto Tax Calculator — Tips & Tricks 📊\n\n## Data Preparation\n\n1. **Export from every exchange** — Don't forget DEX trades! Use blockchain explorers for on-chain swaps.\n2. **Standardize dates** — Make sure all CSVs use the same timezone. UTC is recommended.\n3. **Include fees** — Trading fees are deductible in most jurisdictions and reduce your taxable gains.\n\n## Method Selection\n\n- **FIFO** is safest — Most tax authorities accept it, and it's the default in the US\n- **LIFO** can save taxes in a bull market — You sell the most recently (expensively) bought tokens first\n- **Average Cost** is mandatory in the UK — Don't use FIFO/LIFO for HMRC reporting\n\n## Tax Optimization Tips\n\n- **Tax-loss harvesting** — Sell losing positions before year-end to offset gains\n- **Hold for long-term** — In the US, holding >1 year gets preferential 15-20% rates vs up to 37%\n- **Track airdrops** — Most jurisdictions tax airdrops as income at receipt value\n- **DeFi is taxable** — Swaps, LP entry/exit, and yield farming are all taxable events\n\n## Common Gotchas\n\n- ❌ Forgetting to account for staking rewards (taxed as income)\n- ❌ Ignoring cross-chain bridge transactions (may create taxable events)\n- ❌ Not tracking cost basis for airdropped tokens ($0 basis = 100% gain on sale)\n- ❌ Missing exchange delistings — download your history before an exchange shuts down\n\n## Country-Specific Notes\n\n- 🇺🇸 US: Use the `compare` command to see FIFO vs LIFO side-by-side\n- 🇬🇧 UK: Annual exempt amount is shrinking — use it or lose it\n- 🇦🇺 AU: The 50% CGT discount is powerful — track your holding periods carefully\n- 🇨🇳 CN: Keep records even if enforcement is unclear — regulations can be retroactive\n\nArchive v2.0.0: 5 files, 10495 bytes\n\nFiles: scripts/script.sh (2512b), scripts/tax.sh (20874b), SKILL.md (4098b), tips.md (1750b), _meta.json (134b)\n\nFile v2.0.0:SKILL.md\n\n---\nversion: \"2.0.0\"\nname: Crypto Tax Calculator\ndescription: \"Calculate crypto capital gains taxes with FIFO/LIFO/average cost methods, multi-country tax law support.\"\nauthor: BytesAgain\nhomepage: https://bytesagain.com\nsource: https://github.com/bytesagain/ai-skills\n---\n\n# Crypto Tax Calculator 📊\n\nA complete cryptocurrency tax calculation engine. Import your trades, select your jurisdiction, and generate professional tax reports.\n\n## Workflow Overview\n\n```\n[Import CSV] → [Parse Trades] → [Match Cost Basis] → [Calculate Gains] → [Apply Tax Rules] → [Generate Report]\n     ↓              ↓                  ↓                    ↓                   ↓                    ↓\n  Validate      Normalize         FIFO/LIFO/AVG        Short vs Long       US/UK/AU/CN         HTML + CSV\n  Format        Currencies        Cost Matching         Term Gains          Rate Tables          Tax Report\n```\n\n## Step 1: Prepare Your Data\n\nYour CSV must have these columns (order doesn't matter):\n\n| Column | Required | Format | Example |\n|--------|----------|--------|---------|\n| date | ✅ | YYYY-MM-DD HH:MM:SS | 2024-03-15 14:30:00 |\n| type | ✅ | buy/sell/swap/transfer | buy |\n| asset | ✅ | Symbol | BTC |\n| amount | ✅ | Decimal number | 0.5 |\n| price_usd | ✅ | USD value per unit | 65000.00 |\n| fee_usd | ❌ | Fee in USD | 2.50 |\n| exchange | ❌ | Exchange name | Binance |\n| tx_hash | ❌ | Transaction hash | 0xabc... |\n\n## Step 2: Choose Your Method\n\n```bash\n# FIFO — First In, First Out (most common, required in some jurisdictions)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method fifo --country US\n\n# LIFO — Last In, First Out (can minimize taxes in rising markets)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method lifo --country US\n\n# Average Cost — Weighted average (required in UK, simpler calculation)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method average --country UK\n```\n\n## Step 3: Select Jurisdiction\n\n### 🇺🇸 United States\n- Short-term gains (<1 year): Taxed as ordinary income (10%-37%)\n- Long-term gains (>1 year): 0%, 15%, or 20%\n- Wash sale rules: Currently not enforced for crypto (may change)\n- Form 8949 generation supported\n\n### 🇬🇧 United Kingdom\n- Capital Gains Tax: 10% (basic) / 20% (higher rate)\n- Annual exempt amount: £6,000 (2024/25)\n- Must use share pooling (average cost)\n- HMRC-compatible report format\n\n### 🇦🇺 Australia\n- CGT discount: 50% for assets held >12 months\n- Marginal tax rates apply (19%-45%)\n- Personal use asset exemption <$10,000\n- ATO-compatible output\n\n### 🇨🇳 China\n- Individual income tax: 20% on gains\n- Currently ambiguous regulation\n- Report provides gain calculations for reference\n\n## Step 4: Generate Report\n\nThe tool outputs:\n- **HTML Report** — Visual summary with charts, tables, per-asset breakdown\n- **CSV Export** — Machine-readable gain/loss per trade\n- **Summary JSON** — Totals for integration with other tools\n\n## Full Command Reference\n\n```bash\n# Calculate taxes\nbash scripts/crypto-tax-calc.sh calculate --input FILE --method METHOD --country CODE [--year YEAR]\n\n# Validate CSV format\nbash scripts/crypto-tax-calc.sh validate --input FILE\n\n# Show summary only (no report file)\nbash scripts/crypto-tax-calc.sh summary --input FILE --method METHOD\n\n# Merge multiple exchange CSVs\nbash scripts/crypto-tax-calc.sh merge --inputs \"file1.csv,file2.csv\" --output merged.csv\n\n# Compare methods side-by-side\nbash scripts/crypto-tax-calc.sh compare --input FILE --country CODE\n```\n\n## Important Disclaimers\n\n⚠️ This tool is for **informational purposes only**. It is NOT tax advice. Consult a qualified tax professional for your specific situation.\n\n⚠️ Tax laws change frequently. Always verify current rates and rules with your local tax authority.\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\n- `import` — Import\n- `calculate` — Calculate\n- `add` — Add\n- `report` — Report\n- `compare-methods` — Compare Methods\n\nFile v2.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"crypto-tax-calc\",\n  \"version\": \"2.0.0\",\n  \"publishedAt\": 1773773494042\n}\n\nFile v2.0.0:tips.md\n\n# Crypto Tax Calculator — Tips & Tricks 📊\n\n## Data Preparation\n\n1. **Export from every exchange** — Don't forget DEX trades! Use blockchain explorers for on-chain swaps.\n2. **Standardize dates** — Make sure all CSVs use the same timezone. UTC is recommended.\n3. **Include fees** — Trading fees are deductible in most jurisdictions and reduce your taxable gains.\n\n## Method Selection\n\n- **FIFO** is safest — Most tax authorities accept it, and it's the default in the US\n- **LIFO** can save taxes in a bull market — You sell the most recently (expensively) bought tokens first\n- **Average Cost** is mandatory in the UK — Don't use FIFO/LIFO for HMRC reporting\n\n## Tax Optimization Tips\n\n- **Tax-loss harvesting** — Sell losing positions before year-end to offset gains\n- **Hold for long-term** — In the US, holding >1 year gets preferential 15-20% rates vs up to 37%\n- **Track airdrops** — Most jurisdictions tax airdrops as income at receipt value\n- **DeFi is taxable** — Swaps, LP entry/exit, and yield farming are all taxable events\n\n## Common Gotchas\n\n- ❌ Forgetting to account for staking rewards (taxed as income)\n- ❌ Ignoring cross-chain bridge transactions (may create taxable events)\n- ❌ Not tracking cost basis for airdropped tokens ($0 basis = 100% gain on sale)\n- ❌ Missing exchange delistings — download your history before an exchange shuts down\n\n## Country-Specific Notes\n\n- 🇺🇸 US: Use the `compare` command to see FIFO vs LIFO side-by-side\n- 🇬🇧 UK: Annual exempt amount is shrinking — use it or lose it\n- 🇦🇺 AU: The 50% CGT discount is powerful — track your holding periods carefully\n- 🇨🇳 CN: Keep records even if enforcement is unclear — regulations can be retroactive\n\nArchive v2.4.5: 5 files, 10509 bytes\n\nFiles: scripts/script.sh (2512b), scripts/tax.sh (20874b), SKILL.md (4123b), tips.md (1750b), _meta.json (134b)\n\nFile v2.4.5:SKILL.md\n\n---\nversion: \"2.0.0\"\nname: Crypto Tax Calculator\ndescription: \"Calculate crypto capital gains taxes with FIFO/LIFO/average cost methods, multi-country tax law support, and HTML report generation. Use when you need crypto tax calc capabilities. Triggers on: crypto tax calc.\"\nauthor: BytesAgain\n---\n\n# Crypto Tax Calculator 📊\n\nA complete cryptocurrency tax calculation engine. Import your trades, select your jurisdiction, and generate professional tax reports.\n\n## Workflow Overview\n\n```\n[Import CSV] → [Parse Trades] → [Match Cost Basis] → [Calculate Gains] → [Apply Tax Rules] → [Generate Report]\n     ↓              ↓                  ↓                    ↓                   ↓                    ↓\n  Validate      Normalize         FIFO/LIFO/AVG        Short vs Long       US/UK/AU/CN         HTML + CSV\n  Format        Currencies        Cost Matching         Term Gains          Rate Tables          Tax Report\n```\n\n## Step 1: Prepare Your Data\n\nYour CSV must have these columns (order doesn't matter):\n\n| Column | Required | Format | Example |\n|--------|----------|--------|---------|\n| date | ✅ | YYYY-MM-DD HH:MM:SS | 2024-03-15 14:30:00 |\n| type | ✅ | buy/sell/swap/transfer | buy |\n| asset | ✅ | Symbol | BTC |\n| amount | ✅ | Decimal number | 0.5 |\n| price_usd | ✅ | USD value per unit | 65000.00 |\n| fee_usd | ❌ | Fee in USD | 2.50 |\n| exchange | ❌ | Exchange name | Binance |\n| tx_hash | ❌ | Transaction hash | 0xabc... |\n\n## Step 2: Choose Your Method\n\n```bash\n# FIFO — First In, First Out (most common, required in some jurisdictions)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method fifo --country US\n\n# LIFO — Last In, First Out (can minimize taxes in rising markets)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method lifo --country US\n\n# Average Cost — Weighted average (required in UK, simpler calculation)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method average --country UK\n```\n\n## Step 3: Select Jurisdiction\n\n### 🇺🇸 United States\n- Short-term gains (<1 year): Taxed as ordinary income (10%-37%)\n- Long-term gains (>1 year): 0%, 15%, or 20%\n- Wash sale rules: Currently not enforced for crypto (may change)\n- Form 8949 generation supported\n\n### 🇬🇧 United Kingdom\n- Capital Gains Tax: 10% (basic) / 20% (higher rate)\n- Annual exempt amount: £6,000 (2024/25)\n- Must use share pooling (average cost)\n- HMRC-compatible report format\n\n### 🇦🇺 Australia\n- CGT discount: 50% for assets held >12 months\n- Marginal tax rates apply (19%-45%)\n- Personal use asset exemption <$10,000\n- ATO-compatible output\n\n### 🇨🇳 China\n- Individual income tax: 20% on gains\n- Currently ambiguous regulation\n- Report provides gain calculations for reference\n\n## Step 4: Generate Report\n\nThe tool outputs:\n- **HTML Report** — Visual summary with charts, tables, per-asset breakdown\n- **CSV Export** — Machine-readable gain/loss per trade\n- **Summary JSON** — Totals for integration with other tools\n\n## Full Command Reference\n\n```bash\n# Calculate taxes\nbash scripts/crypto-tax-calc.sh calculate --input FILE --method METHOD --country CODE [--year YEAR]\n\n# Validate CSV format\nbash scripts/crypto-tax-calc.sh validate --input FILE\n\n# Show summary only (no report file)\nbash scripts/crypto-tax-calc.sh summary --input FILE --method METHOD\n\n# Merge multiple exchange CSVs\nbash scripts/crypto-tax-calc.sh merge --inputs \"file1.csv,file2.csv\" --output merged.csv\n\n# Compare methods side-by-side\nbash scripts/crypto-tax-calc.sh compare --input FILE --country CODE\n```\n\n## Important Disclaimers\n\n⚠️ This tool is for **informational purposes only**. It is NOT tax advice. Consult a qualified tax professional for your specific situation.\n\n⚠️ Tax laws change frequently. Always verify current rates and rules with your local tax authority.\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\n- `import` — Import\n- `calculate` — Calculate\n- `add` — Add\n- `report` — Report\n- `compare-methods` — Compare Methods\n\nFile v2.4.5:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"crypto-tax-calc\",\n  \"version\": \"2.4.5\",\n  \"publishedAt\": 1773665559740\n}\n\nFile v2.4.5:tips.md\n\n# Crypto Tax Calculator — Tips & Tricks 📊\n\n## Data Preparation\n\n1. **Export from every exchange** — Don't forget DEX trades! Use blockchain explorers for on-chain swaps.\n2. **Standardize dates** — Make sure all CSVs use the same timezone. UTC is recommended.\n3. **Include fees** — Trading fees are deductible in most jurisdictions and reduce your taxable gains.\n\n## Method Selection\n\n- **FIFO** is safest — Most tax authorities accept it, and it's the default in the US\n- **LIFO** can save taxes in a bull market — You sell the most recently (expensively) bought tokens first\n- **Average Cost** is mandatory in the UK — Don't use FIFO/LIFO for HMRC reporting\n\n## Tax Optimization Tips\n\n- **Tax-loss harvesting** — Sell losing positions before year-end to offset gains\n- **Hold for long-term** — In the US, holding >1 year gets preferential 15-20% rates vs up to 37%\n- **Track airdrops** — Most jurisdictions tax airdrops as income at receipt value\n- **DeFi is taxable** — Swaps, LP entry/exit, and yield farming are all taxable events\n\n## Common Gotchas\n\n- ❌ Forgetting to account for staking rewards (taxed as income)\n- ❌ Ignoring cross-chain bridge transactions (may create taxable events)\n- ❌ Not tracking cost basis for airdropped tokens ($0 basis = 100% gain on sale)\n- ❌ Missing exchange delistings — download your history before an exchange shuts down\n\n## Country-Specific Notes\n\n- 🇺🇸 US: Use the `compare` command to see FIFO vs LIFO side-by-side\n- 🇬🇧 UK: Annual exempt amount is shrinking — use it or lose it\n- 🇦🇺 AU: The 50% CGT discount is powerful — track your holding periods carefully\n- 🇨🇳 CN: Keep records even if enforcement is unclear — regulations can be retroactive\n\nArchive v2.4.4: 5 files, 10508 bytes\n\nFiles: scripts/script.sh (2512b), scripts/tax.sh (20874b), SKILL.md (4123b), tips.md (1750b), _meta.json (134b)\n\nFile v2.4.4:SKILL.md\n\n---\nversion: \"2.0.0\"\nname: Crypto Tax Calculator\ndescription: \"Calculate crypto capital gains taxes with FIFO/LIFO/average cost methods, multi-country tax law support, and HTML report generation. Use when you need crypto tax calc capabilities. Triggers on: crypto tax calc.\"\nauthor: BytesAgain\n---\n\n# Crypto Tax Calculator 📊\n\nA complete cryptocurrency tax calculation engine. Import your trades, select your jurisdiction, and generate professional tax reports.\n\n## Workflow Overview\n\n```\n[Import CSV] → [Parse Trades] → [Match Cost Basis] → [Calculate Gains] → [Apply Tax Rules] → [Generate Report]\n     ↓              ↓                  ↓                    ↓                   ↓                    ↓\n  Validate      Normalize         FIFO/LIFO/AVG        Short vs Long       US/UK/AU/CN         HTML + CSV\n  Format        Currencies        Cost Matching         Term Gains          Rate Tables          Tax Report\n```\n\n## Step 1: Prepare Your Data\n\nYour CSV must have these columns (order doesn't matter):\n\n| Column | Required | Format | Example |\n|--------|----------|--------|---------|\n| date | ✅ | YYYY-MM-DD HH:MM:SS | 2024-03-15 14:30:00 |\n| type | ✅ | buy/sell/swap/transfer | buy |\n| asset | ✅ | Symbol | BTC |\n| amount | ✅ | Decimal number | 0.5 |\n| price_usd | ✅ | USD value per unit | 65000.00 |\n| fee_usd | ❌ | Fee in USD | 2.50 |\n| exchange | ❌ | Exchange name | Binance |\n| tx_hash | ❌ | Transaction hash | 0xabc... |\n\n## Step 2: Choose Your Method\n\n```bash\n# FIFO — First In, First Out (most common, required in some jurisdictions)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method fifo --country US\n\n# LIFO — Last In, First Out (can minimize taxes in rising markets)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method lifo --country US\n\n# Average Cost — Weighted average (required in UK, simpler calculation)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method average --country UK\n```\n\n## Step 3: Select Jurisdiction\n\n### 🇺🇸 United States\n- Short-term gains (<1 year): Taxed as ordinary income (10%-37%)\n- Long-term gains (>1 year): 0%, 15%, or 20%\n- Wash sale rules: Currently not enforced for crypto (may change)\n- Form 8949 generation supported\n\n### 🇬🇧 United Kingdom\n- Capital Gains Tax: 10% (basic) / 20% (higher rate)\n- Annual exempt amount: £6,000 (2024/25)\n- Must use share pooling (average cost)\n- HMRC-compatible report format\n\n### 🇦🇺 Australia\n- CGT discount: 50% for assets held >12 months\n- Marginal tax rates apply (19%-45%)\n- Personal use asset exemption <$10,000\n- ATO-compatible output\n\n### 🇨🇳 China\n- Individual income tax: 20% on gains\n- Currently ambiguous regulation\n- Report provides gain calculations for reference\n\n## Step 4: Generate Report\n\nThe tool outputs:\n- **HTML Report** — Visual summary with charts, tables, per-asset breakdown\n- **CSV Export** — Machine-readable gain/loss per trade\n- **Summary JSON** — Totals for integration with other tools\n\n## Full Command Reference\n\n```bash\n# Calculate taxes\nbash scripts/crypto-tax-calc.sh calculate --input FILE --method METHOD --country CODE [--year YEAR]\n\n# Validate CSV format\nbash scripts/crypto-tax-calc.sh validate --input FILE\n\n# Show summary only (no report file)\nbash scripts/crypto-tax-calc.sh summary --input FILE --method METHOD\n\n# Merge multiple exchange CSVs\nbash scripts/crypto-tax-calc.sh merge --inputs \"file1.csv,file2.csv\" --output merged.csv\n\n# Compare methods side-by-side\nbash scripts/crypto-tax-calc.sh compare --input FILE --country CODE\n```\n\n## Important Disclaimers\n\n⚠️ This tool is for **informational purposes only**. It is NOT tax advice. Consult a qualified tax professional for your specific situation.\n\n⚠️ Tax laws change frequently. Always verify current rates and rules with your local tax authority.\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\n- `import` — Import\n- `calculate` — Calculate\n- `add` — Add\n- `report` — Report\n- `compare-methods` — Compare Methods\n\nFile v2.4.4:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"crypto-tax-calc\",\n  \"version\": \"2.4.4\",\n  \"publishedAt\": 1773662293322\n}\n\nFile v2.4.4:tips.md\n\n# Crypto Tax Calculator — Tips & Tricks 📊\n\n## Data Preparation\n\n1. **Export from every exchange** — Don't forget DEX trades! Use blockchain explorers for on-chain swaps.\n2. **Standardize dates** — Make sure all CSVs use the same timezone. UTC is recommended.\n3. **Include fees** — Trading fees are deductible in most jurisdictions and reduce your taxable gains.\n\n## Method Selection\n\n- **FIFO** is safest — Most tax authorities accept it, and it's the default in the US\n- **LIFO** can save taxes in a bull market — You sell the most recently (expensively) bought tokens first\n- **Average Cost** is mandatory in the UK — Don't use FIFO/LIFO for HMRC reporting\n\n## Tax Optimization Tips\n\n- **Tax-loss harvesting** — Sell losing positions before year-end to offset gains\n- **Hold for long-term** — In the US, holding >1 year gets preferential 15-20% rates vs up to 37%\n- **Track airdrops** — Most jurisdictions tax airdrops as income at receipt value\n- **DeFi is taxable** — Swaps, LP entry/exit, and yield farming are all taxable events\n\n## Common Gotchas\n\n- ❌ Forgetting to account for staking rewards (taxed as income)\n- ❌ Ignoring cross-chain bridge transactions (may create taxable events)\n- ❌ Not tracking cost basis for airdropped tokens ($0 basis = 100% gain on sale)\n- ❌ Missing exchange delistings — download your history before an exchange shuts down\n\n## Country-Specific Notes\n\n- 🇺🇸 US: Use the `compare` command to see FIFO vs LIFO side-by-side\n- 🇬🇧 UK: Annual exempt amount is shrinking — use it or lose it\n- 🇦🇺 AU: The 50% CGT discount is powerful — track your holding periods carefully\n- 🇨🇳 CN: Keep records even if enforcement is unclear — regulations can be retroactive\n\nArchive v2.4.3: 4 files, 9374 bytes\n\nFiles: scripts/tax.sh (20874b), SKILL.md (4087b), tips.md (1750b), _meta.json (134b)\n\nFile v2.4.3:SKILL.md\n\n---\nname: Crypto Tax Calculator\ndescription: \"Calculate crypto capital gains taxes with FIFO/LIFO/average cost methods, multi-country tax law support, and HTML report generation. Use when you need crypto tax calc capabilities. Triggers on: crypto tax calc.\"\n---\n\n# Crypto Tax Calculator 📊\n\nA complete cryptocurrency tax calculation engine. Import your trades, select your jurisdiction, and generate professional tax reports.\n\n## Workflow Overview\n\n```\n[Import CSV] → [Parse Trades] → [Match Cost Basis] → [Calculate Gains] → [Apply Tax Rules] → [Generate Report]\n     ↓              ↓                  ↓                    ↓                   ↓                    ↓\n  Validate      Normalize         FIFO/LIFO/AVG        Short vs Long       US/UK/AU/CN         HTML + CSV\n  Format        Currencies        Cost Matching         Term Gains          Rate Tables          Tax Report\n```\n\n## Step 1: Prepare Your Data\n\nYour CSV must have these columns (order doesn't matter):\n\n| Column | Required | Format | Example |\n|--------|----------|--------|---------|\n| date | ✅ | YYYY-MM-DD HH:MM:SS | 2024-03-15 14:30:00 |\n| type | ✅ | buy/sell/swap/transfer | buy |\n| asset | ✅ | Symbol | BTC |\n| amount | ✅ | Decimal number | 0.5 |\n| price_usd | ✅ | USD value per unit | 65000.00 |\n| fee_usd | ❌ | Fee in USD | 2.50 |\n| exchange | ❌ | Exchange name | Binance |\n| tx_hash | ❌ | Transaction hash | 0xabc... |\n\n## Step 2: Choose Your Method\n\n```bash\n# FIFO — First In, First Out (most common, required in some jurisdictions)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method fifo --country US\n\n# LIFO — Last In, First Out (can minimize taxes in rising markets)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method lifo --country US\n\n# Average Cost — Weighted average (required in UK, simpler calculation)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method average --country UK\n```\n\n## Step 3: Select Jurisdiction\n\n### 🇺🇸 United States\n- Short-term gains (<1 year): Taxed as ordinary income (10%-37%)\n- Long-term gains (>1 year): 0%, 15%, or 20%\n- Wash sale rules: Currently not enforced for crypto (may change)\n- Form 8949 generation supported\n\n### 🇬🇧 United Kingdom\n- Capital Gains Tax: 10% (basic) / 20% (higher rate)\n- Annual exempt amount: £6,000 (2024/25)\n- Must use share pooling (average cost)\n- HMRC-compatible report format\n\n### 🇦🇺 Australia\n- CGT discount: 50% for assets held >12 months\n- Marginal tax rates apply (19%-45%)\n- Personal use asset exemption <$10,000\n- ATO-compatible output\n\n### 🇨🇳 China\n- Individual income tax: 20% on gains\n- Currently ambiguous regulation\n- Report provides gain calculations for reference\n\n## Step 4: Generate Report\n\nThe tool outputs:\n- **HTML Report** — Visual summary with charts, tables, per-asset breakdown\n- **CSV Export** — Machine-readable gain/loss per trade\n- **Summary JSON** — Totals for integration with other tools\n\n## Full Command Reference\n\n```bash\n# Calculate taxes\nbash scripts/crypto-tax-calc.sh calculate --input FILE --method METHOD --country CODE [--year YEAR]\n\n# Validate CSV format\nbash scripts/crypto-tax-calc.sh validate --input FILE\n\n# Show summary only (no report file)\nbash scripts/crypto-tax-calc.sh summary --input FILE --method METHOD\n\n# Merge multiple exchange CSVs\nbash scripts/crypto-tax-calc.sh merge --inputs \"file1.csv,file2.csv\" --output merged.csv\n\n# Compare methods side-by-side\nbash scripts/crypto-tax-calc.sh compare --input FILE --country CODE\n```\n\n## Important Disclaimers\n\n⚠️ This tool is for **informational purposes only**. It is NOT tax advice. Consult a qualified tax professional for your specific situation.\n\n⚠️ Tax laws change frequently. Always verify current rates and rules with your local tax authority.\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\n- `import` — Import\n- `calculate` — Calculate\n- `add` — Add\n- `report` — Report\n- `compare-methods` — Compare Methods\n\nFile v2.4.3:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"crypto-tax-calc\",\n  \"version\": \"2.4.3\",\n  \"publishedAt\": 1773610879664\n}\n\nFile v2.4.3:tips.md\n\n# Crypto Tax Calculator — Tips & Tricks 📊\n\n## Data Preparation\n\n1. **Export from every exchange** — Don't forget DEX trades! Use blockchain explorers for on-chain swaps.\n2. **Standardize dates** — Make sure all CSVs use the same timezone. UTC is recommended.\n3. **Include fees** — Trading fees are deductible in most jurisdictions and reduce your taxable gains.\n\n## Method Selection\n\n- **FIFO** is safest — Most tax authorities accept it, and it's the default in the US\n- **LIFO** can save taxes in a bull market — You sell the most recently (expensively) bought tokens first\n- **Average Cost** is mandatory in the UK — Don't use FIFO/LIFO for HMRC reporting\n\n## Tax Optimization Tips\n\n- **Tax-loss harvesting** — Sell losing positions before year-end to offset gains\n- **Hold for long-term** — In the US, holding >1 year gets preferential 15-20% rates vs up to 37%\n- **Track airdrops** — Most jurisdictions tax airdrops as income at receipt value\n- **DeFi is taxable** — Swaps, LP entry/exit, and yield farming are all taxable events\n\n## Common Gotchas\n\n- ❌ Forgetting to account for staking rewards (taxed as income)\n- ❌ Ignoring cross-chain bridge transactions (may create taxable events)\n- ❌ Not tracking cost basis for airdropped tokens ($0 basis = 100% gain on sale)\n- ❌ Missing exchange delistings — download your history before an exchange shuts down\n\n## Country-Specific Notes\n\n- 🇺🇸 US: Use the `compare` command to see FIFO vs LIFO side-by-side\n- 🇬🇧 UK: Annual exempt amount is shrinking — use it or lose it\n- 🇦🇺 AU: The 50% CGT discount is powerful — track your holding periods carefully\n- 🇨🇳 CN: Keep records even if enforcement is unclear — regulations can be retroactive\n\nArchive v2.4.2: 4 files, 9374 bytes\n\nFiles: scripts/tax.sh (20874b), SKILL.md (4087b), tips.md (1750b), _meta.json (134b)\n\nFile v2.4.2:SKILL.md\n\n---\nname: Crypto Tax Calculator\ndescription: \"Calculate crypto capital gains taxes with FIFO/LIFO/average cost methods, multi-country tax law support, and HTML report generation. Use when you need crypto tax calc capabilities. Triggers on: crypto tax calc.\"\n---\n\n# Crypto Tax Calculator 📊\n\nA complete cryptocurrency tax calculation engine. Import your trades, select your jurisdiction, and generate professional tax reports.\n\n## Workflow Overview\n\n```\n[Import CSV] → [Parse Trades] → [Match Cost Basis] → [Calculate Gains] → [Apply Tax Rules] → [Generate Report]\n     ↓              ↓                  ↓                    ↓                   ↓                    ↓\n  Validate      Normalize         FIFO/LIFO/AVG        Short vs Long       US/UK/AU/CN         HTML + CSV\n  Format        Currencies        Cost Matching         Term Gains          Rate Tables          Tax Report\n```\n\n## Step 1: Prepare Your Data\n\nYour CSV must have these columns (order doesn't matter):\n\n| Column | Required | Format | Example |\n|--------|----------|--------|---------|\n| date | ✅ | YYYY-MM-DD HH:MM:SS | 2024-03-15 14:30:00 |\n| type | ✅ | buy/sell/swap/transfer | buy |\n| asset | ✅ | Symbol | BTC |\n| amount | ✅ | Decimal number | 0.5 |\n| price_usd | ✅ | USD value per unit | 65000.00 |\n| fee_usd | ❌ | Fee in USD | 2.50 |\n| exchange | ❌ | Exchange name | Binance |\n| tx_hash | ❌ | Transaction hash | 0xabc... |\n\n## Step 2: Choose Your Method\n\n```bash\n# FIFO — First In, First Out (most common, required in some jurisdictions)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method fifo --country US\n\n# LIFO — Last In, First Out (can minimize taxes in rising markets)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method lifo --country US\n\n# Average Cost — Weighted average (required in UK, simpler calculation)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method average --country UK\n```\n\n## Step 3: Select Jurisdiction\n\n### 🇺🇸 United States\n- Short-term gains (<1 year): Taxed as ordinary income (10%-37%)\n- Long-term gains (>1 year): 0%, 15%, or 20%\n- Wash sale rules: Currently not enforced for crypto (may change)\n- Form 8949 generation supported\n\n### 🇬🇧 United Kingdom\n- Capital Gains Tax: 10% (basic) / 20% (higher rate)\n- Annual exempt amount: £6,000 (2024/25)\n- Must use share pooling (average cost)\n- HMRC-compatible report format\n\n### 🇦🇺 Australia\n- CGT discount: 50% for assets held >12 months\n- Marginal tax rates apply (19%-45%)\n- Personal use asset exemption <$10,000\n- ATO-compatible output\n\n### 🇨🇳 China\n- Individual income tax: 20% on gains\n- Currently ambiguous regulation\n- Report provides gain calculations for reference\n\n## Step 4: Generate Report\n\nThe tool outputs:\n- **HTML Report** — Visual summary with charts, tables, per-asset breakdown\n- **CSV Export** — Machine-readable gain/loss per trade\n- **Summary JSON** — Totals for integration with other tools\n\n## Full Command Reference\n\n```bash\n# Calculate taxes\nbash scripts/crypto-tax-calc.sh calculate --input FILE --method METHOD --country CODE [--year YEAR]\n\n# Validate CSV format\nbash scripts/crypto-tax-calc.sh validate --input FILE\n\n# Show summary only (no report file)\nbash scripts/crypto-tax-calc.sh summary --input FILE --method METHOD\n\n# Merge multiple exchange CSVs\nbash scripts/crypto-tax-calc.sh merge --inputs \"file1.csv,file2.csv\" --output merged.csv\n\n# Compare methods side-by-side\nbash scripts/crypto-tax-calc.sh compare --input FILE --country CODE\n```\n\n## Important Disclaimers\n\n⚠️ This tool is for **informational purposes only**. It is NOT tax advice. Consult a qualified tax professional for your specific situation.\n\n⚠️ Tax laws change frequently. Always verify current rates and rules with your local tax authority.\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\n- `import` — Import\n- `calculate` — Calculate\n- `add` — Add\n- `report` — Report\n- `compare-methods` — Compare Methods\n\nFile v2.4.2:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"crypto-tax-calc\",\n  \"version\": \"2.4.2\",\n  \"publishedAt\": 1773578689131\n}\n\nFile v2.4.2:tips.md\n\n# Crypto Tax Calculator — Tips & Tricks 📊\n\n## Data Preparation\n\n1. **Export from every exchange** — Don't forget DEX trades! Use blockchain explorers for on-chain swaps.\n2. **Standardize dates** — Make sure all CSVs use the same timezone. UTC is recommended.\n3. **Include fees** — Trading fees are deductible in most jurisdictions and reduce your taxable gains.\n\n## Method Selection\n\n- **FIFO** is safest — Most tax authorities accept it, and it's the default in the US\n- **LIFO** can save taxes in a bull market — You sell the most recently (expensively) bought tokens first\n- **Average Cost** is mandatory in the UK — Don't use FIFO/LIFO for HMRC reporting\n\n## Tax Optimization Tips\n\n- **Tax-loss harvesting** — Sell losing positions before year-end to offset gains\n- **Hold for long-term** — In the US, holding >1 year gets preferential 15-20% rates vs up to 37%\n- **Track airdrops** — Most jurisdictions tax airdrops as income at receipt value\n- **DeFi is taxable** — Swaps, LP entry/exit, and yield farming are all taxable events\n\n## Common Gotchas\n\n- ❌ Forgetting to account for staking rewards (taxed as income)\n- ❌ Ignoring cross-chain bridge transactions (may create taxable events)\n- ❌ Not tracking cost basis for airdropped tokens ($0 basis = 100% gain on sale)\n- ❌ Missing exchange delistings — download your history before an exchange shuts down\n\n## Country-Specific Notes\n\n- 🇺🇸 US: Use the `compare` command to see FIFO vs LIFO side-by-side\n- 🇬🇧 UK: Annual exempt amount is shrinking — use it or lose it\n- 🇦🇺 AU: The 50% CGT discount is powerful — track your holding periods carefully\n- 🇨🇳 CN: Keep records even if enforcement is unclear — regulations can be retroactive\n\nArchive v2.4.1: 4 files, 9375 bytes\n\nFiles: scripts/tax.sh (20874b), SKILL.md (4088b), tips.md (1750b), _meta.json (134b)\n\nFile v2.4.1:SKILL.md\n\n---\nname: Crypto Tax Calculator\ndescription: \"Calculate crypto capital gains taxes with FIFO/LIFO/average cost methods, multi-country tax law support, and HTML report generation. Use when you need crypto tax calc capabilities. Triggers on: crypto tax calc.\"\n---\n\n# Crypto Tax Calculator 📊\n\nA complete cryptocurrency tax calculation engine. Import your trades, select your jurisdiction, and generate professional tax reports.\n\n## Workflow Overview\n\n```\n[Import CSV] → [Parse Trades] → [Match Cost Basis] → [Calculate Gains] → [Apply Tax Rules] → [Generate Report]\n     ↓              ↓                  ↓                    ↓                   ↓                    ↓\n  Validate      Normalize         FIFO/LIFO/AVG        Short vs Long       US/UK/AU/CN         HTML + CSV\n  Format        Currencies        Cost Matching         Term Gains          Rate Tables          Tax Report\n```\n\n## Step 1: Prepare Your Data\n\nYour CSV must have these columns (order doesn't matter):\n\n| Column | Required | Format | Example |\n|--------|----------|--------|---------|\n| date | ✅ | YYYY-MM-DD HH:MM:SS | 2024-03-15 14:30:00 |\n| type | ✅ | buy/sell/swap/transfer | buy |\n| asset | ✅ | Symbol | BTC |\n| amount | ✅ | Decimal number | 0.5 |\n| price_usd | ✅ | USD value per unit | 65000.00 |\n| fee_usd | ❌ | Fee in USD | 2.50 |\n| exchange | ❌ | Exchange name | Binance |\n| tx_hash | ❌ | Transaction hash | 0xabc... |\n\n## Step 2: Choose Your Method\n\n```bash\n# FIFO — First In, First Out (most common, required in some jurisdictions)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method fifo --country US\n\n# LIFO — Last In, First Out (can minimize taxes in rising markets)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method lifo --country US\n\n# Average Cost — Weighted average (required in UK, simpler calculation)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method average --country UK\n```\n\n## Step 3: Select Jurisdiction\n\n### 🇺🇸 United States\n- Short-term gains (<1 year): Taxed as ordinary income (10%-37%)\n- Long-term gains (>1 year): 0%, 15%, or 20%\n- Wash sale rules: Currently not enforced for crypto (may change)\n- Form 8949 generation supported\n\n### 🇬🇧 United Kingdom\n- Capital Gains Tax: 10% (basic) / 20% (higher rate)\n- Annual exempt amount: £6,000 (2024/25)\n- Must use share pooling (average cost)\n- HMRC-compatible report format\n\n### 🇦🇺 Australia\n- CGT discount: 50% for assets held >12 months\n- Marginal tax rates apply (19%-45%)\n- Personal use asset exemption <$10,000\n- ATO-compatible output\n\n### 🇨🇳 China\n- Individual income tax: 20% on gains\n- Currently ambiguous regulation\n- Report provides gain calculations for reference\n\n## Step 4: Generate Report\n\nThe tool outputs:\n- **HTML Report** — Visual summary with charts, tables, per-asset breakdown\n- **CSV Export** — Machine-readable gain/loss per trade\n- **Summary JSON** — Totals for integration with other tools\n\n## Full Command Reference\n\n```bash\n# Calculate taxes\nbash scripts/crypto-tax-calc.sh calculate --input FILE --method METHOD --country CODE [--year YEAR]\n\n# Validate CSV format\nbash scripts/crypto-tax-calc.sh validate --input FILE\n\n# Show summary only (no report file)\nbash scripts/crypto-tax-calc.sh summary --input FILE --method METHOD\n\n# Merge multiple exchange CSVs\nbash scripts/crypto-tax-calc.sh merge --inputs \"file1.csv,file2.csv\" --output merged.csv\n\n# Compare methods side-by-side\nbash scripts/crypto-tax-calc.sh compare --input FILE --country CODE\n```\n\n## Important Disclaimers\n\n⚠️ This tool is for **informational purposes only**. It is NOT tax advice. Consult a qualified tax professional for your specific situation.\n\n⚠️ Tax laws change frequently. Always verify current rates and rules with your local tax authority.\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n\n## Commands\n\n- `import` — Import\n- `calculate` — Calculate\n- `add` — Add\n- `report` — Report\n- `compare-methods` — Compare Methods\n\nFile v2.4.1:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"crypto-tax-calc\",\n  \"version\": \"2.4.1\",\n  \"publishedAt\": 1773536656858\n}\n\nFile v2.4.1:tips.md\n\n# Crypto Tax Calculator — Tips & Tricks 📊\n\n## Data Preparation\n\n1. **Export from every exchange** — Don't forget DEX trades! Use blockchain explorers for on-chain swaps.\n2. **Standardize dates** — Make sure all CSVs use the same timezone. UTC is recommended.\n3. **Include fees** — Trading fees are deductible in most jurisdictions and reduce your taxable gains.\n\n## Method Selection\n\n- **FIFO** is safest — Most tax authorities accept it, and it's the default in the US\n- **LIFO** can save taxes in a bull market — You sell the most recently (expensively) bought tokens first\n- **Average Cost** is mandatory in the UK — Don't use FIFO/LIFO for HMRC reporting\n\n## Tax Optimization Tips\n\n- **Tax-loss harvesting** — Sell losing positions before year-end to offset gains\n- **Hold for long-term** — In the US, holding >1 year gets preferential 15-20% rates vs up to 37%\n- **Track airdrops** — Most jurisdictions tax airdrops as income at receipt value\n- **DeFi is taxable** — Swaps, LP entry/exit, and yield farming are all taxable events\n\n## Common Gotchas\n\n- ❌ Forgetting to account for staking rewards (taxed as income)\n- ❌ Ignoring cross-chain bridge transactions (may create taxable events)\n- ❌ Not tracking cost basis for airdropped tokens ($0 basis = 100% gain on sale)\n- ❌ Missing exchange delistings — download your history before an exchange shuts down\n\n## Country-Specific Notes\n\n- 🇺🇸 US: Use the `compare` command to see FIFO vs LIFO side-by-side\n- 🇬🇧 UK: Annual exempt amount is shrinking — use it or lose it\n- 🇦🇺 AU: The 50% CGT discount is powerful — track your holding periods carefully\n- 🇨🇳 CN: Keep records even if enforcement is unclear — regulations can be retroactive\n\nArchive v2.4.0: 4 files, 9378 bytes\n\nFiles: scripts/tax.sh (20874b), SKILL.md (4093b), tips.md (1750b), _meta.json (134b)\n\nFile v2.4.0:SKILL.md\n\n---\nname: Crypto Tax Calculator\ndescription: \"Calculate crypto capital gains taxes with FIFO/LIFO/average cost methods, multi-country tax law support, and HTML report generation. Use when you need crypto tax calc capabilities. Triggers on: crypto tax calc.\"\n---\n\n# Crypto Tax Calculator 📊\n\nA comprehensive cryptocurrency tax calculation engine. Import your trades, select your jurisdiction, and generate professional tax reports.\n\n## Workflow Overview\n\n```\n[Import CSV] → [Parse Trades] → [Match Cost Basis] → [Calculate Gains] → [Apply Tax Rules] → [Generate Report]\n     ↓              ↓                  ↓                    ↓                   ↓                    ↓\n  Validate      Normalize         FIFO/LIFO/AVG        Short vs Long       US/UK/AU/CN         HTML + CSV\n  Format        Currencies        Cost Matching         Term Gains          Rate Tables          Tax Report\n```\n\n## Step 1: Prepare Your Data\n\nYour CSV must have these columns (order doesn't matter):\n\n| Column | Required | Format | Example |\n|--------|----------|--------|---------|\n| date | ✅ | YYYY-MM-DD HH:MM:SS | 2024-03-15 14:30:00 |\n| type | ✅ | buy/sell/swap/transfer | buy |\n| asset | ✅ | Symbol | BTC |\n| amount | ✅ | Decimal number | 0.5 |\n| price_usd | ✅ | USD value per unit | 65000.00 |\n| fee_usd | ❌ | Fee in USD | 2.50 |\n| exchange | ❌ | Exchange name | Binance |\n| tx_hash | ❌ | Transaction hash | 0xabc... |\n\n## Step 2: Choose Your Method\n\n```bash\n# FIFO — First In, First Out (most common, required in some jurisdictions)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method fifo --country US\n\n# LIFO — Last In, First Out (can minimize taxes in rising markets)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method lifo --country US\n\n# Average Cost — Weighted average (required in UK, simpler calculation)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method average --country UK\n```\n\n## Step 3: Select Jurisdiction\n\n### 🇺🇸 United States\n- Short-term gains (<1 year): Taxed as ordinary income (10%-37%)\n- Long-term gains (>1 year): 0%, 15%, or 20%\n- Wash sale rules: Currently not enforced for crypto (may change)\n- Form 8949 generation supported\n\n### 🇬🇧 United Kingdom\n- Capital Gains Tax: 10% (basic) / 20% (higher rate)\n- Annual exempt amount: £6,000 (2024/25)\n- Must use share pooling (average cost)\n- HMRC-compatible report format\n\n### 🇦🇺 Australia\n- CGT discount: 50% for assets held >12 months\n- Marginal tax rates apply (19%-45%)\n- Personal use asset exemption <$10,000\n- ATO-compatible output\n\n### 🇨🇳 China\n- Individual income tax: 20% on gains\n- Currently ambiguous regulation\n- Report provides gain calculations for reference\n\n## Step 4: Generate Report\n\nThe tool outputs:\n- **HTML Report** — Visual summary with charts, tables, per-asset breakdown\n- **CSV Export** — Machine-readable gain/loss per trade\n- **Summary JSON** — Totals for integration with other tools\n\n## Full Command Reference\n\n```bash\n# Calculate taxes\nbash scripts/crypto-tax-calc.sh calculate --input FILE --method METHOD --country CODE [--year YEAR]\n\n# Validate CSV format\nbash scripts/crypto-tax-calc.sh validate --input FILE\n\n# Show summary only (no report file)\nbash scripts/crypto-tax-calc.sh summary --input FILE --method METHOD\n\n# Merge multiple exchange CSVs\nbash scripts/crypto-tax-calc.sh merge --inputs \"file1.csv,file2.csv\" --output merged.csv\n\n# Compare methods side-by-side\nbash scripts/crypto-tax-calc.sh compare --input FILE --country CODE\n```\n\n## Important Disclaimers\n\n⚠️ This tool is for **informational purposes only**. It is NOT tax advice. Consult a qualified tax professional for your specific situation.\n\n⚠️ Tax laws change frequently. Always verify current rates and rules with your local tax authority.\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n\n## Commands\n\n- `import` — Import\n- `calculate` — Calculate\n- `add` — Add\n- `report` — Report\n- `compare-methods` — Compare Methods\n\nFile v2.4.0:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"crypto-tax-calc\",\n  \"version\": \"2.4.0\",\n  \"publishedAt\": 1773452359564\n}\n\nFile v2.4.0:tips.md\n\n# Crypto Tax Calculator — Tips & Tricks 📊\n\n## Data Preparation\n\n1. **Export from every exchange** — Don't forget DEX trades! Use blockchain explorers for on-chain swaps.\n2. **Standardize dates** — Make sure all CSVs use the same timezone. UTC is recommended.\n3. **Include fees** — Trading fees are deductible in most jurisdictions and reduce your taxable gains.\n\n## Method Selection\n\n- **FIFO** is safest — Most tax authorities accept it, and it's the default in the US\n- **LIFO** can save taxes in a bull market — You sell the most recently (expensively) bought tokens first\n- **Average Cost** is mandatory in the UK — Don't use FIFO/LIFO for HMRC reporting\n\n## Tax Optimization Tips\n\n- **Tax-loss harvesting** — Sell losing positions before year-end to offset gains\n- **Hold for long-term** — In the US, holding >1 year gets preferential 15-20% rates vs up to 37%\n- **Track airdrops** — Most jurisdictions tax airdrops as income at receipt value\n- **DeFi is taxable** — Swaps, LP entry/exit, and yield farming are all taxable events\n\n## Common Gotchas\n\n- ❌ Forgetting to account for staking rewards (taxed as income)\n- ❌ Ignoring cross-chain bridge transactions (may create taxable events)\n- ❌ Not tracking cost basis for airdropped tokens ($0 basis = 100% gain on sale)\n- ❌ Missing exchange delistings — download your history before an exchange shuts down\n\n## Country-Specific Notes\n\n- 🇺🇸 US: Use the `compare` command to see FIFO vs LIFO side-by-side\n- 🇬🇧 UK: Annual exempt amount is shrinking — use it or lose it\n- 🇦🇺 AU: The 50% CGT discount is powerful — track your holding periods carefully\n- 🇨🇳 CN: Keep records even if enforcement is unclear — regulations can be retroactive\n\nArchive v2.3.0: 4 files, 9324 bytes\n\nFiles: scripts/tax.sh (20874b), SKILL.md (3950b), tips.md (1750b), _meta.json (134b)\n\nFile v2.3.0:SKILL.md\n\n---\nname: Crypto Tax Calculator\ndescription: \"Calculate crypto capital gains taxes with FIFO/LIFO/average cost methods, multi-country tax law support, and HTML report generation. Use when you need crypto tax calc capabilities. Triggers on: crypto tax calc.\"\n---\n\n# Crypto Tax Calculator 📊\n\nA comprehensive cryptocurrency tax calculation engine. Import your trades, select your jurisdiction, and generate professional tax reports.\n\n## Workflow Overview\n\n```\n[Import CSV] → [Parse Trades] → [Match Cost Basis] → [Calculate Gains] → [Apply Tax Rules] → [Generate Report]\n     ↓              ↓                  ↓                    ↓                   ↓                    ↓\n  Validate      Normalize         FIFO/LIFO/AVG        Short vs Long       US/UK/AU/CN         HTML + CSV\n  Format        Currencies        Cost Matching         Term Gains          Rate Tables          Tax Report\n```\n\n## Step 1: Prepare Your Data\n\nYour CSV must have these columns (order doesn't matter):\n\n| Column | Required | Format | Example |\n|--------|----------|--------|---------|\n| date | ✅ | YYYY-MM-DD HH:MM:SS | 2024-03-15 14:30:00 |\n| type | ✅ | buy/sell/swap/transfer | buy |\n| asset | ✅ | Symbol | BTC |\n| amount | ✅ | Decimal number | 0.5 |\n| price_usd | ✅ | USD value per unit | 65000.00 |\n| fee_usd | ❌ | Fee in USD | 2.50 |\n| exchange | ❌ | Exchange name | Binance |\n| tx_hash | ❌ | Transaction hash | 0xabc... |\n\n## Step 2: Choose Your Method\n\n```bash\n# FIFO — First In, First Out (most common, required in some jurisdictions)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method fifo --country US\n\n# LIFO — Last In, First Out (can minimize taxes in rising markets)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method lifo --country US\n\n# Average Cost — Weighted average (required in UK, simpler calculation)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method average --country UK\n```\n\n## Step 3: Select Jurisdiction\n\n### 🇺🇸 United States\n- Short-term gains (<1 year): Taxed as ordinary income (10%-37%)\n- Long-term gains (>1 year): 0%, 15%, or 20%\n- Wash sale rules: Currently not enforced for crypto (may change)\n- Form 8949 generation supported\n\n### 🇬🇧 United Kingdom\n- Capital Gains Tax: 10% (basic) / 20% (higher rate)\n- Annual exempt amount: £6,000 (2024/25)\n- Must use share pooling (average cost)\n- HMRC-compatible report format\n\n### 🇦🇺 Australia\n- CGT discount: 50% for assets held >12 months\n- Marginal tax rates apply (19%-45%)\n- Personal use asset exemption <$10,000\n- ATO-compatible output\n\n### 🇨🇳 China\n- Individual income tax: 20% on gains\n- Currently ambiguous regulation\n- Report provides gain calculations for reference\n\n## Step 4: Generate Report\n\nThe tool outputs:\n- **HTML Report** — Visual summary with charts, tables, per-asset breakdown\n- **CSV Export** — Machine-readable gain/loss per trade\n- **Summary JSON** — Totals for integration with other tools\n\n## Full Command Reference\n\n```bash\n# Calculate taxes\nbash scripts/crypto-tax-calc.sh calculate --input FILE --method METHOD --country CODE [--year YEAR]\n\n# Validate CSV format\nbash scripts/crypto-tax-calc.sh validate --input FILE\n\n# Show summary only (no report file)\nbash scripts/crypto-tax-calc.sh summary --input FILE --method METHOD\n\n# Merge multiple exchange CSVs\nbash scripts/crypto-tax-calc.sh merge --inputs \"file1.csv,file2.csv\" --output merged.csv\n\n# Compare methods side-by-side\nbash scripts/crypto-tax-calc.sh compare --input FILE --country CODE\n```\n\n## Important Disclaimers\n\n⚠️ This tool is for **informational purposes only**. It is NOT tax advice. Consult a qualified tax professional for your specific situation.\n\n⚠️ Tax laws change frequently. Always verify current rates and rules with your local tax authority.\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\nFile v2.3.0:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"crypto-tax-calc\",\n  \"version\": \"2.3.0\",\n  \"publishedAt\": 1773447552503\n}\n\nFile v2.3.0:tips.md\n\n# Crypto Tax Calculator — Tips & Tricks 📊\n\n## Data Preparation\n\n1. **Export from every exchange** — Don't forget DEX trades! Use blockchain explorers for on-chain swaps.\n2. **Standardize dates** — Make sure all CSVs use the same timezone. UTC is recommended.\n3. **Include fees** — Trading fees are deductible in most jurisdictions and reduce your taxable gains.\n\n## Method Selection\n\n- **FIFO** is safest — Most tax authorities accept it, and it's the default in the US\n- **LIFO** can save taxes in a bull market — You sell the most recently (expensively) bought tokens first\n- **Average Cost** is mandatory in the UK — Don't use FIFO/LIFO for HMRC reporting\n\n## Tax Optimization Tips\n\n- **Tax-loss harvesting** — Sell losing positions before year-end to offset gains\n- **Hold for long-term** — In the US, holding >1 year gets preferential 15-20% rates vs up to 37%\n- **Track airdrops** — Most jurisdictions tax airdrops as income at receipt value\n- **DeFi is taxable** — Swaps, LP entry/exit, and yield farming are all taxable events\n\n## Common Gotchas\n\n- ❌ Forgetting to account for staking rewards (taxed as income)\n- ❌ Ignoring cross-chain bridge transactions (may create taxable events)\n- ❌ Not tracking cost basis for airdropped tokens ($0 basis = 100% gain on sale)\n- ❌ Missing exchange delistings — download your history before an exchange shuts down\n\n## Country-Specific Notes\n\n- 🇺🇸 US: Use the `compare` command to see FIFO vs LIFO side-by-side\n- 🇬🇧 UK: Annual exempt amount is shrinking — use it or lose it\n- 🇦🇺 AU: The 50% CGT discount is powerful — track your holding periods carefully\n- 🇨🇳 CN: Keep records even if enforcement is unclear — regulations can be retroactive","readmeExcerpt":"Skill: Crypto Tax Calc Owner: bytesagain-lab Summary: Cryptocurrency tax reference — IRS guidance, FIFO/LIFO/HIFO cost basis methods, Form 8949, tax loss harvesting, and DeFi transaction categorization Tags: chinese:1.0.0, latest:3.0.0, productivity:1.0.1 Version history: v3.0.0 | 2026-03-23T00:46:18.671Z | user Clean package with matching SKILL.md and script v2.0.1 | 2026-03-18T10:40:05.279Z | user update v2.0.0 | 2","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# Record a transaction\ncrypto-tax-calc track \"coffee shop\" 4.50\n\n# Check your current balance\ncrypto-tax-calc balance\n\n# View monthly financial summary\ncrypto-tax-calc summary\n\n# Export all transactions to CSV (pipe to file)\ncrypto-tax-calc export > transactions.csv\n\n# Review budget breakdown by category\ncrypto-tax-calc budget\n\n# View recent transaction history\ncrypto-tax-calc history\n\n# Set a price alert\ncrypto-tax-calc alert \"BTC\" 70000\n\n# Compare current vs previous period\ncrypto-tax-calc compare\n\n# Get a simple forecast based on trends\ncrypto-tax-calc forecast\n\n# View available spending categories\ncrypto-tax-calc categories"},{"language":"text","snippet":"[Import CSV] → [Parse Trades] → [Match Cost Basis] → [Calculate Gains] → [Apply Tax Rules] → [Generate Report]\n     ↓              ↓                  ↓                    ↓                   ↓                    ↓\n  Validate      Normalize         FIFO/LIFO/AVG        Short vs Long       US/UK/AU/CN         HTML + CSV\n  Format        Currencies        Cost Matching         Term Gains          Rate Tables          Tax Report"},{"language":"bash","snippet":"# FIFO — First In, First Out (most common, required in some jurisdictions)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method fifo --country US\n\n# LIFO — Last In, First Out (can minimize taxes in rising markets)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method lifo --country US\n\n# Average Cost — Weighted average (required in UK, simpler calculation)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method average --country UK"},{"language":"bash","snippet":"# Calculate taxes\nbash scripts/crypto-tax-calc.sh calculate --input FILE --method METHOD --country CODE [--year YEAR]\n\n# Validate CSV format\nbash scripts/crypto-tax-calc.sh validate --input FILE\n\n# Show summary only (no report file)\nbash scripts/crypto-tax-calc.sh summary --input FILE --method METHOD\n\n# Merge multiple exchange CSVs\nbash scripts/crypto-tax-calc.sh merge --inputs \"file1.csv,file2.csv\" --output merged.csv\n\n# Compare methods side-by-side\nbash scripts/crypto-tax-calc.sh compare --input FILE --country CODE"},{"language":"text","snippet":"[Import CSV] → [Parse Trades] → [Match Cost Basis] → [Calculate Gains] → [Apply Tax Rules] → [Generate Report]\n     ↓              ↓                  ↓                    ↓                   ↓                    ↓\n  Validate      Normalize         FIFO/LIFO/AVG        Short vs Long       US/UK/AU/CN         HTML + CSV\n  Format        Currencies        Cost Matching         Term Gains          Rate Tables          Tax Report"},{"language":"bash","snippet":"# FIFO — First In, First Out (most common, required in some jurisdictions)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method fifo --country US\n\n# LIFO — Last In, First Out (can minimize taxes in rising markets)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method lifo --country US\n\n# Average Cost — Weighted average (required in UK, simpler calculation)\nbash scripts/crypto-tax-calc.sh calculate --input trades.csv --method average --country UK"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: \"crypto-tax-calc\"\nversion: \"3.0.0\"\ndescription: \"Cryptocurrency tax reference — IRS guidance, FIFO/LIFO/HIFO cost basis methods, Form 8949, tax loss harvesting, and DeFi transaction categorization\"\nauthor: \"BytesAgain\"\nhomepage: \"https://bytesagain.com\"\nsource: \"https://github.com/bytesagain/ai-skills\"\ntags: [crypto-tax, irs, capital-gains, form-8949, defi]\ncategory: \"blockchain\"\n---\n\n# Crypto Tax Calc\n\nCryptocurrency tax reference — IRS guidance, FIFO/LIFO/HIFO cost basis methods, Form 8949, tax loss harvesting, and DeFi transaction categorization. No API keys or credentials required — outputs reference documentation only.\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `intro` | Taxable events, tax categories, IRS guidance |\n| `standards` | Cost basis methods, Form 8949, reporting |\n| `troubleshooting` | Missing basis, DeFi categorization, wash sales |\n| `performance` | Tax loss harvesting, donation strategy |\n| `security` | Record-keeping, audit preparation, FBAR |\n| `migration` | Spreadsheet to tax software, exchange exports |\n| `cheatsheet` | Tax brackets, form fields, key dates |\n| `faq` | Reporting requirements, gas fees, IRS tracking |\n\n## Output Format\n\nAll commands output plain-text reference documentation via heredoc. No external API calls, no credentials needed, no network access.\n\n---\n\n*Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"crypto-tax-calc\",\n  \"version\": \"3.0.0\",\n  \"publishedAt\": 1774226778671\n}"},{"path":"skill-card.md","content":"## Description:\n\nCryptocurrency tax reference covering IRS guidance, FIFO/LIFO/HIFO cost basis methods, Form 8949, tax loss harvesting, and DeFi transaction categorization.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[bytesagain-lab](https://clawhub.ai/user/bytesagain-lab)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill as a quick reference for cryptocurrency tax concepts, reporting categories, record keeping, and migration to tax software. It is reference guidance only and should be checked against current rules for the relevant jurisdiction and tax year.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Tax guidance can become outdated or vary by jurisdiction and tax year.\n\nMitigation: Confirm the information against current official guidance for the relevant jurisdiction and tax year, or consult a qualified tax professional before filing or tax planning.\n\nRisk: Users may mistake reference documentation for personalized tax advice.\n\nMitigation: Use the skill as a quick reference only and review transaction-specific decisions with appropriate professional support.\n\n## Reference(s):\n\n- [Crypto Tax Calc on ClawHub](https://clawhub.ai/bytesagain-lab/skills/crypto-tax-calc)\n- [Publisher profile: bytesagain-lab](https://clawhub.ai/user/bytesagain-lab)\n- [BytesAgain homepage](https://bytesagain.com)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, guidance]\n\n**Output Format:** [Plain-text reference documentation with Markdown headings and tables]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [No credentials, network access, persistence, or hidden execution indicated by security evidence.]\n\n## Skill Version(s):\n\n3.0.0 (source: frontmatter and release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Cryptocurrency tax reference — IRS guidance, FIFO/LIFO/HIFO cost basis methods, Form 8949, tax loss harvesting, and DeFi transaction categorization Skill: Crypto Tax Calc Owner: bytesagain-lab Summary: Cryptocurrency tax reference — IRS guidance, FIFO/LIFO/HIFO cost basis methods, Form 8949, tax loss harvesting, and DeFi transaction categorization Tags: chinese:1.0.0, latest:3.0.0, productivity:1.0.1 Version history: v3.0.0 | 2026-03-23T00:46:18.671Z | user Clean package with matching SKILL.md and script v2.0.1 | 2026-03-18T10:40:05.279Z | user update v2.0.0 | 2","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":871,"uniquenessScore":54,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T12:40:47.800Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T12:40:47.800Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T14:44:19.397Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}