Agent skill

Calculating Crypto Taxes

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

Calculate cryptocurrency tax obligations with cost basis tracking, capital gains computation, and Form 8949 generation.

MITAuto-check passedBusiness, Finance & HR

Install Calculating Crypto Taxes

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill calculating-crypto-taxes -a claude-code

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

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace calculating-crypto-taxes --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/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/calculating-crypto-taxes .claude/skills/calculating-crypto-taxes && 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
calculating-crypto-taxes
GitHub stars
2.8k
Token cost
~1.2k tokens
SKILL.md length
318 words
Files
13 (incl. scripts, references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Calculate cryptocurrency tax obligations with cost basis tracking, capital gains computation, and Form 8949 generation.

  • Works in 6 steps: Prepare transaction data by exporting… → Run basic tax calculation using FIFO… → Compare cost basis methods to understand… → …
  • Calculating crypto taxes
  • SKILL.md covers Overview, Prerequisites, Instructions and Output, plus 3 more sections
  • Runs Python scripts from its folder; calls python

What it does

Calculating Crypto Taxes is an agent skill from jeremylongshore/tons-of-skills-marketplace. 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".

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 15 other files, including scripts and reference files (for example `ARD.md`, `PRD.md` and `config/settings.yaml`). Compatibility notes: Designed for Claude Code

It sits in Business, Finance & HR, covering Crypto and DeFi analysis. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Calculating crypto taxes
  • Generating tax reports
  • Comparing cost basis methods
  • Identifying taxable events

Example prompts

  • “calculate crypto taxes”
  • “generate tax report”
  • “cost basis FIFO”
  • “/calculating-crypto-taxes”

Requirements

  • Python 3
  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Read, Write, Bash(crypto:tax-*)

Workflow steps

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

  1. Prepare transaction data by exporting CSV from each exchange
  2. Run basic tax calculation using FIFO (IRS default)
  3. Compare cost basis methods to understand tax implications
  4. Generate Form 8949 report as CSV
  5. Handle income events (staking, airdrops, mining, DeFi yield)
  6. Consolidate multi-exchange data into a unified report

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Bash(crypto:tax-*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 5 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

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

  • Network

    Links to these hosts (documentation or services it may open):

    • irs.gov

    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.

  • Compatibility

    Designed for Claude Code

    From compatibility in the SKILL.md frontmatter.

Context cost

Calculating Crypto Taxes loads about 1.2k tokens when it runs, and up to ~7.8k if it reads all its reference files. Until then it costs about 104 tokens; SKILL.md has 318 words of instructions outside code blocks.

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

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 jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 318 words, ~1,160 tokens.

Download SKILL.mdSave it as .claude/skills/calculating-crypto-taxes/SKILL.md (or your agent's skills folder). This skill also uses 12 other files; get the full folder from GitHub.
name
calculating-crypto-taxes
description
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".
allowed-tools
Read, Write, Bash(crypto:tax-*)
compatibility
Designed for Claude Code
version
1.27.0
author
Jeremy Longshore <jeremy@intentsolutions.io>
license
MIT
tags
crypto, cost-optimization, calculating-crypto

Calculating Crypto Taxes

Overview

Calculate cryptocurrency tax obligations from transaction history. Supports FIFO, LIFO, and HIFO cost basis methods, identifies taxable events (trades, staking, airdrops), and generates Form 8949 compatible reports.

DISCLAIMER: This tool provides informational calculations only, not tax advice. Consult a qualified tax professional.

Prerequisites

  • Transaction history exported as CSV from your exchanges (Coinbase, Binance, Kraken, etc.)
  • Python 3.8+ installed
  • Understanding of your tax jurisdiction's crypto rules

Instructions

  1. Prepare transaction data by exporting CSV from each exchange:

    ExchangeExport Location
    CoinbaseReports > Tax documents > Transaction history CSV
    BinanceOrders > Trade History > Export
    KrakenHistory > Export
    GenericSee ${CLAUDE_SKILL_DIR}/references/exchange_formats.md for column mapping
  2. Run basic tax calculation using FIFO (IRS default):

    bash
    python ${CLAUDE_SKILL_DIR}/scripts/tax_calculator.py --transactions your_trades.csv --year 2025  # 2025 = tax year
  3. Compare cost basis methods to understand tax implications:

    bash
    python ${CLAUDE_SKILL_DIR}/scripts/tax_calculator.py --transactions trades.csv --compare-methods

    Methods: --method fifo (IRS default), --method lifo (Last In First Out), --method hifo (minimize gains)

  4. Generate Form 8949 report as CSV:

    bash
    python ${CLAUDE_SKILL_DIR}/scripts/tax_calculator.py --transactions trades.csv --method fifo --year 2025 --output form_8949.csv --format csv  # 2025 = tax year
  5. Handle income events (staking, airdrops, mining, DeFi yield):

    bash
    python ${CLAUDE_SKILL_DIR}/scripts/tax_calculator.py --transactions all_events.csv --income-report
  6. Consolidate multi-exchange data into a unified report:

    bash
    python ${CLAUDE_SKILL_DIR}/scripts/tax_calculator.py --transactions coinbase.csv binance.csv kraken.csv --year 2025  # 2025 = tax year
Show full SKILL.md (157 more words)Show less

Output

Reports include short-term and long-term capital gains/losses broken down by transaction, with proceeds, cost basis, and gain/loss per disposal. Summary shows total proceeds, total cost basis, net capital gain, and short/long-term split. Income report lists staking, airdrop, and mining income with fair market values.

See ${CLAUDE_SKILL_DIR}/references/implementation.md for detailed output format examples.

Error Handling

ErrorCauseFix
Missing columnsCSV format mismatchVerify format matches exchange template
Unknown transaction typeUnrecognized event categoryReview and manually categorize
Insufficient lotsMissing buy transactionsCheck for missing imports or transfers

Examples

Basic FIFO tax calculation - Standard IRS-default method for a single exchange:

bash
python tax_calculator.py --transactions trades.csv --year 2025  # 2025 = tax year

HIFO to minimize gains - Highest-cost lots disposed first to reduce taxable gain:

bash
python tax_calculator.py --transactions trades.csv --method hifo --year 2025  # 2025 = tax year

JSON output for processing - Machine-readable export for tax software integration:

bash
python tax_calculator.py --transactions trades.csv --format json --output tax_data.json

Verbose with lot details - See which specific lots were matched to each disposal:

bash
python tax_calculator.py --transactions trades.csv --verbose --show-lots

Resources

© jeremylongshore, 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 12 other files (scripts, references) in skills/.curated/calculating-crypto-taxes of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • ARD.md
  • PRD.md
  • config/settings.yaml
  • references/errors.md
  • references/examples.md
  • references/exchange_formats.md
  • references/implementation.md
  • scripts/cost_basis_engine.py
  • scripts/report_generator.py
  • scripts/tax_calculator.py
  • scripts/tax_engine.py
  • scripts/transaction_parser.py

Open the folder on GitHubat commit cfae287

Compare with similar skills

Calculating Crypto Taxes 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.

Calculating Crypto Taxes compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Calculating Crypto Taxes this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.2kAutomated safety check: PassMIT
Technical Analysttradermonty/claude-trading-skills3k4 repos~4.6kAutomated safety check: PassMIT
Polyclawchainstacklabs/polyclaw3591 repos~2kAutomated safety check: PassApache-2.0
Longbridge Researchhelsome/folio2713 repos~2.1kAutomated safety check: PassMIT
Stock Analysis24mlight/StockClaw1012 repos~2kAutomated safety check: NotesMIT
Swapper Depositswapperfinance/swapper-toolkit852—~1.8kAutomated safety check: PassMIT

Similar skills

  • 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
  • Stock Analysis

    24mlight/StockClaw

    Analyze stocks and cryptocurrencies using Yahoo Finance data.

    101 GitHub starsUsed in 2 repos~2k tokens
    Business, Finance & HRAuto-check: notes
  • Swapper Deposit

    swapperfinance/swapper-toolkit

    Deposit and bridge funds into a wallet or protocol using Swapper Finance.

    852 GitHub stars~1.8k tokensUpdated 6 mo ago
    Business, Finance & HRAuto-check passed
  • Okx Cex Earn

    okx/agent-skills

    Manages OKX Simple Earn (flexible savings/lending), Flash Earn, On-chain Earn (staking/DeFi), Dual Investment (DCD/双币赢), and AutoEarn (自动赚币) via the okx CLI.

    187 GitHub starsUsed in 2 repos~3.3k tokens
    Business, Finance & HRAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Questions about Calculating Crypto Taxes

What does Calculating Crypto Taxes do?

Calculate cryptocurrency tax obligations with cost basis tracking, capital gains computation, and Form 8949 generation. Calculating Crypto Taxes is an agent skill from jeremylongshore/tons-of-skills-marketplace. Calculate cryptocurrency tax obligations with cost basis tracking, capital gains computation, and Form 8949 generation.

When should I use Calculating Crypto Taxes?

Calculating Crypto Taxes fits situations like: calculating crypto taxes; generating tax reports; comparing cost basis methods; identifying taxable events.

How do I install Calculating Crypto Taxes in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill calculating-crypto-taxes -a claude-code`. Or copy the skill folder (skills/.curated/calculating-crypto-taxes in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/calculating-crypto-taxes in your project. Claude Code loads it when a task matches its description.

How do I install Calculating Crypto Taxes in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill calculating-crypto-taxes -a codex`. Or copy the skill folder (skills/.curated/calculating-crypto-taxes in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/calculating-crypto-taxes in your project. Codex loads it when a task matches its description.

Can I use Calculating Crypto Taxes 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 jeremylongshore/tons-of-skills-marketplace --skill calculating-crypto-taxes -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/calculating-crypto-taxes, .gemini/skills/calculating-crypto-taxes, .github/skills/calculating-crypto-taxes and .opencode/skills/calculating-crypto-taxes in your project.

What does Calculating Crypto Taxes need to run?

Going by SKILL.md and its folder, Calculating Crypto Taxes needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Read, Write, Bash(crypto:tax-*). Compatibility (from SKILL.md): Designed for Claude Code.

Does Calculating Crypto Taxes access the network?

SKILL.md names 1 domain. As links in the text: irs.gov. This is read from the text; nothing was executed.

Is Calculating Crypto Taxes 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 Calculating Crypto Taxes use?

Calculating Crypto Taxes 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 Calculating Crypto Taxes use?

About 1.2k tokens (SKILL.md is roughly 4.6k 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 6.6k tokens, read only when the agent opens those files.

What are the alternatives to Calculating Crypto Taxes?

Skills that share tags, products or a category with Calculating Crypto Taxes: Technical Analyst (tradermonty/claude-trading-skills, 3k stars), Polyclaw (chainstacklabs/polyclaw, 359 stars), Longbridge Research (helsome/folio, 271 stars) and Stock Analysis (24mlight/StockClaw, 101 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Calculating Crypto Taxes?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 2026.

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