CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

uk-sole-trader-tax

UK self-employed (sole trader) tax rules for this invoicing app - income tax bands, personal allowance taper, Class 2/4 NIC, cash basis, payments on account, more than one trade, trading allowance, Making Tax Digital, invoice content. Use before changing anything under src/utils/taxCalculator.ts, the Dashboard or Accounting pages, expense handling, or PDF invoice content, and when writing or reviewing tax tests.

Quality

92%

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

93%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.

A model domain-knowledge skill: dense rule table with exact figures tied to specific code locations, hard guardrails against inventing rates, an explicit do-not-encode list for unsourced questions, and a test-first change workflow with regression gates. The only gap is an unstated failure path in the workflow (what to do when npm run check or eval:compliance fails).

DimensionReasoningScore

Conciseness

Lean and dense: no explanation of concepts Claude already knows (no 'what is income tax' padding), every table row carries a rule plus where it bites in this specific codebase, and even the intro paragraph supplies only non-derivable project context (two trades, England-only). Matches anchor 5 — every token earns its place; anchor 4 would require sections that could be trimmed, and none are evident.

5 / 5

Actionability

As an instruction-only skill it gives fully actionable guidance: exact figures and dates for every rule (£37,700 / £125,140 bands, £7,105 threshold, £3.65/week, MTD thresholds by year), specific file paths ('src/utils/taxCalculator.ts', 'src/pdf/', 'references/rates-2026-27.md', 'evals/compliance/'), runnable commands ('npm run check', 'npm run eval:compliance'), and per-row statements of what is currently wrong in the code. This meets anchor 5 for an instruction-only skill per the scoring notes.

5 / 5

Workflow Clarity

'When you change tax code' gives a clear five-step sequence with explicit validation checkpoints (write the compliance case first with source and worked example, then run 'npm run check (regression gate) and npm run eval:compliance', then promote passing cases into 'tests/'). It falls between anchors 4 and 5: validation steps are explicit (anchor 5) but no error-recovery feedback loop ('if the gate fails, fix and re-run') is spelled out, matching anchor 4's 'minor validation gaps'.

4 / 5

Progressive Disclosure

A clear overview that centralizes all figures in one well-signaled, one-level-deep reference that actually exists and is well-sourced ('Every figure lives in references/rates-2026-27.md with its gov.uk source'; step 1 'Read references/rates-2026-27.md'; verified the file exists with gov.uk URLs and per-year tables). The SKILL.md body carries only rules and app-specific context, which is the appropriate split. Matches anchor 5.

5 / 5

Total

19

/

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.

An excellent description: it states a precise what, enumerates a comprehensive and concrete scope, and gives file-level trigger guidance for when to use it. The only weaknesses are missing natural synonyms ('Self Assessment', 'National Insurance', 'HMRC') and topic-noun rather than verb phrasing.

Suggestions

Add the natural synonyms users say: 'Self Assessment' (the return sole traders file), 'National Insurance' spelled out, and 'HMRC' — currently only the jargon 'Class 2/4 NIC' appears.

Lead with one or two action verbs (e.g. 'Applies UK sole-trader tax rules... Checks tax calculations against...') so the description names what the skill does, not just the topics it covers.

DimensionReasoningScore

Specificity

The description enumerates ten concrete rule areas ('income tax bands, personal allowance taper, Class 2/4 NIC, cash basis, payments on account, more than one trade, trading allowance, Making Tax Digital, invoice content') with no fluff, but capabilities are stated as topic nouns rather than actions — what the skill does with these rules is only implied by 'tax rules for this invoicing app'. This is above anchor 3 (which covers only 1-2 concrete items) but falls short of anchor 5's 'multiple specific concrete actions'.

4 / 5

Completeness

Explicitly answers both questions: the 'what' is 'UK self-employed (sole trader) tax rules for this invoicing app' with an enumerated scope, and the 'when' is concrete — 'Use before changing anything under src/utils/taxCalculator.ts, the Dashboard or Accounting pages, expense handling, or PDF invoice content, and when writing or reviewing tax tests.' This matches anchor 5 exactly; anchor 4 would require a weaker or less specific 'when'.

5 / 5

Trigger Term Quality

Strong natural terms a user would actually say: 'UK', 'self-employed (sole trader)', 'tax', 'income tax', 'NIC', 'cash basis', 'payments on account', 'invoice'. Anchor 5 is not met because common synonyms are missing — 'Self Assessment' (the return UK sole traders file), 'National Insurance' spelled out, and 'HMRC' are absent, leaving only the jargon 'Class 2/4 NIC'.

4 / 5

Distinctiveness Conflict Risk

A clear niche — UK sole-trader tax for one specific app — with triggers pinned to concrete file paths ('src/utils/taxCalculator.ts', 'PDF invoice content', 'tax tests'), making accidental triggering by other skills (e.g. general invoicing or PDF skills) very unlikely. Matches anchor 5's 'clear niche with distinct triggers; minimal conflict risk'.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

mmtsfasman/adulting-invoicing-app-demo

Path

.claude/skills/uk-sole-trader-tax/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.