Skip to content

jeremylongshore/tons-of-skills-marketplace / plugins/crypto/crypto-tax-calculator/skills/calculating-crypto-taxes

calculating-crypto-taxes

Verified

Calculate cryptocurrency tax obligations with cost basis tracking, capital gains computation, and Form 8949 generation. Use when calculating crypto taxes, generating tax reports, comparing cost basis methods, or identifying taxable events. Trigger with phrases like "calculate crypto taxes", "generate tax report", "cost basis FIFO", "capital gains", "Form 8949", or "crypto taxable events".

FileKindSize
ARD.mdmarkdown9.8 KB
PRD.mdmarkdown6.6 KB
SKILL.mdskill md4.6 KB
config/settings.yamlconfig5.5 KB
references/errors.mdmarkdown6.6 KB
references/examples.mdmarkdown10.5 KB
references/exchange_formats.mdmarkdown5.7 KB
references/implementation.mdmarkdown3.1 KB
scripts/cost_basis_engine.pyscript11.3 KB
scripts/report_generator.pyscript15.3 KB
scripts/tax_calculator.pyscript5.5 KB
scripts/tax_engine.pyscript9.6 KB
scripts/transaction_parser.pyscript10.9 KB

config/settings.yaml

View on GitHub
# Crypto Tax Calculator Configuration
# Version: 2.0.0

# =============================================================================
# Default Settings
# =============================================================================

defaults:
  cost_basis_method: fifo           # fifo, lifo, hifo
  output_format: table              # table, json, csv
  holding_period_days: 365          # Days for long-term classification
  report_width: 78                  # Terminal output width

# =============================================================================
# Tax Year Configuration
# =============================================================================

tax_year:
  # US tax year (January 1 - December 31)
  start_month: 1
  start_day: 1

  # Set to true if using fiscal year
  use_fiscal_year: false

# =============================================================================
# Exchange CSV Formats
# =============================================================================

exchange_formats:
  coinbase:
    date_col: "Timestamp"
    type_col: "Transaction Type"
    asset_col: "Asset"
    quantity_col: "Quantity Transacted"
    price_col: "Spot Price at Transaction"
    fee_col: "Fees and/or Spread"
    date_format: "%Y-%m-%dT%H:%M:%SZ"

  binance:
    date_col: "Date(UTC)"
    type_col: "Operation"
    asset_col: "Coin"
    quantity_col: "Change"
    price_col: null                  # Requires manual price lookup
    fee_col: null
    date_format: "%Y-%m-%d %H:%M:%S"

  kraken:
    date_col: "time"
    type_col: "type"
    asset_col: "asset"
    quantity_col: "amount"
    price_col: null
    fee_col: "fee"
    date_format: "%Y-%m-%d %H:%M:%S.%f"

  gemini:
    date_col: "Date"
    type_col: "Type"
    asset_col: "Symbol"
    quantity_col: "Amount"
    price_col: "Price"
    fee_col: "Fee"
    date_format: "%Y-%m-%d %H:%M:%S"

  generic:
    date_col: "date"
    type_col: "type"
    asset_col: "asset"
    quantity_col: "quantity"
    price_col: "price"
    fee_col: "fee"
    date_format: null                # Auto-detect

# =============================================================================
# Transaction Type Mapping
# =============================================================================

transaction_types:
  # Acquisitions (create lots)
  acquisitions:
    - buy
    - receive
    - deposit
    - advanced trade buy

  # Disposals (use lots)
  disposals:
    - sell
    - send
    - withdrawal
    - advanced trade sell
    - convert
    - trade
    - swap
    - exchange

  # Income events (taxed at receipt)
  income:
    - staking
    - airdrop
    - mining
    - interest
    - reward
    - rewards income
    - staking income
    - coinbase earn
    - learning reward

  # Non-taxable
  non_taxable:
    - transfer
    - transfer_in
    - transfer_out

# =============================================================================
# Asset Symbol Normalization
# =============================================================================

symbol_mappings:
  # Kraken symbols
  XBT: BTC
  XXBT: BTC
  XETH: ETH
  ZUSD: USD
  ZEUR: EUR
  ZGBP: GBP

  # Common variations
  WBTC: BTC
  WETH: ETH

# =============================================================================
# Historical Price API
# =============================================================================

price_api:
  provider: coingecko
  base_url: "https://api.coingecko.com/api/v3"
  cache_file: ".price_cache.json"
  cache_ttl: 86400                  # Cache for 24 hours (seconds)
  timeout: 15                       # Request timeout in seconds

# =============================================================================
# Output Formatting
# =============================================================================

formatting:
  decimal_places:
    quantity: 8
    price: 2
    value: 2
    percent: 2

  date_format:
    display: "%m/%d/%Y"             # MM/DD/YYYY for reports
    iso: "%Y-%m-%d"                 # ISO format for JSON/CSV

# =============================================================================
# Warnings and Thresholds
# =============================================================================

warnings:
  # Warn if disposing more than available
  warn_insufficient_lots: true

  # Warn if price is missing
  warn_missing_price: true

  # Warn if holding period cannot be determined
  warn_unknown_holding_period: true

  # Maximum rows to show warnings for (0 = all)
  max_warnings: 10

# =============================================================================
# IRS Form 8949 Categories
# =============================================================================

form_8949:
  # Box A: Short-term transactions reported on 1099-B with basis
  # Box B: Short-term transactions NOT reported on 1099-B
  # Box C: Short-term transactions with basis not reported to IRS
  # Box D: Long-term transactions reported on 1099-B with basis
  # Box E: Long-term transactions NOT reported on 1099-B
  # Box F: Long-term transactions with basis not reported to IRS

  # Default to Box C (short) and Box F (long) for crypto
  short_term_box: C
  long_term_box: F

# =============================================================================
# Tax Disclaimer
# =============================================================================

disclaimer: |
  This tool provides informational calculations only. It is NOT tax advice.
  Tax laws vary by jurisdiction and change over time. Consult a qualified
  tax professional for advice specific to your situation. Keep original
  records for audit purposes.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall