CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

calculating-crypto-taxes

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".

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

68%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Highly actionable content with concrete, executable commands and a sensible file structure, weakened by redundancy and absent validation checkpoints. The inline Error Handling and Examples sections duplicate material that already exists as unreferenced bundle files (references/errors.md, references/examples.md).

Suggestions

Add explicit validation checkpoints to the workflow: after step 1, verify each CSV's columns match the exchange template before calculating, and after report generation, sanity-check totals (e.g., transaction counts, net gain) — batch financial processing without verification caps workflow clarity at 3.

Remove the Examples section that duplicates Instructions commands (or fold the unique --format json and --verbose --show-lots variants into Instructions) and drop the repeated '# 2025 = tax year' inline comments to tighten token usage.

Link references/errors.md and references/examples.md from the body (replacing or trimming the inlined error table and examples) so every bundle file is discoverable and content is not duplicated between SKILL.md and the references.

DimensionReasoningScore

Conciseness

The body is mostly lean (command tables, a compact error table, no concept over-explanation), but the Examples section re-presents commands already shown in Instructions, the "# 2025 = tax year" comment is repeated four times, and the IRS links duplicate references/implementation.md. This matches 'mostly efficient but could be tightened' rather than the padded 2 anchor or the trim 4 anchor.

3 / 5

Actionability

Every step is a copy-paste-ready executable command with concrete flags (--method fifo, --income-report, --format csv), full ${CLAUDE_SKILL_DIR} paths, and specific exchange export locations, covering the common cases (basic calc, method comparison, Form 8949, income, multi-exchange). Nothing is pseudocode or abstract, matching the 5 anchor.

5 / 5

Workflow Clarity

Steps 1–6 form a clear numbered sequence, but there are no in-flow validation or verification checkpoints — the Error Handling table is reactive documentation, not a checkpoint, and nothing tells Claude to verify CSV columns before calculating or sanity-check report totals. Because this is batch processing of financial data across many transactions, the rubric's cap for missing validation in batch operations applies, holding this at 3 despite the good sequencing.

3 / 5

Progressive Disclosure

The body is a well-organized overview with clearly signaled one-level-deep links to references/exchange_formats.md and references/implementation.md, both of which exist. However, references/errors.md and references/examples.md are never referenced while their subject matter (error handling, examples) is partially inlined in the body, an organization gap that keeps it below the 5 anchor.

4 / 5

Total

15

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person-imperative, concrete about capabilities, with an explicit 'Use when' clause and a natural trigger-phrase list. The only notable gap is that income-event processing (staking/airdrops/mining), a real capability, is omitted from the stated actions.

DimensionReasoningScore

Specificity

"Calculate cryptocurrency tax obligations with cost basis tracking, capital gains computation, and Form 8949 generation" names the domain plus several concrete actions, matching the 'several specific actions; minor gaps' anchor. It falls short of the 5 anchor because income-event handling (staking, airdrops, mining) — a documented capability of the skill — is not stated.

4 / 5

Completeness

The description explicitly answers 'what' ("Calculate cryptocurrency tax obligations with cost basis tracking, capital gains computation, and Form 8949 generation") and 'when' ("Use when calculating crypto taxes, generating tax reports, comparing cost basis methods, or identifying taxable events"), plus a concrete trigger-phrase list — matching the 5 anchor's structure exactly. Not below 4 because both elements are explicit, not merely present.

5 / 5

Trigger Term Quality

Triggers like "calculate crypto taxes", "generate tax report", "capital gains", "Form 8949", and "crypto taxable events" are natural phrases users would say, giving good coverage. A few natural variants are missing (e.g., "bitcoin taxes", "IRS crypto", "tax loss harvesting"), and "cost basis FIFO" is a slightly unnatural word order, so it does not reach the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

"Form 8949", "cost basis", and "crypto taxable events" carve out a clear crypto-tax niche with distinct triggers and minimal overlap risk against generic finance or document skills. The 4 anchor ('minor overlap risk with closely related skills') is a worse fit since no closely related trigger terms are shared.

5 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

jeremylongshore/tons-of-skills-marketplace

Path

plugins/crypto/crypto-tax-calculator/skills/calculating-crypto-taxes/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.