CtrlK
BlogDocsLog inGet started
Tessl Logo

tech-debt

Track, categorize and prioritize technical debt across the codebase — scans for debt indicators, maintains a register.

61

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/tech-debt/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a strong, highly executable skill definition: every mode has concrete steps, explicit validation gates with defined verdicts, and a fully specified register format. Its only weaknesses are mild redundancy (categories listed three times) and a closing Rules section that pads without instructing.

DimensionReasoningScore

Conciseness

The body is dense with project-specific instructions Claude could not infer (verdict conventions, register schema, scoring formula) and avoids generic concept explanations. Minor trimmable parts remain: the six categories appear three times (scan list, Add-Mode options, register spelling) and the closing Rules section states opinion/rationale ("Tech debt is not inherently bad — it is a tool") that adds little operational value, so it sits at efficient-with-minor-over-explanation rather than fully lean.

4 / 5

Actionability

Guidance is copy-paste ready throughout: exact scan patterns (TODO, FIXME, HACK, @deprecated, >500-line files, >50-line functions), verbatim AskUserQuestion prompts with enumerated options, an exact prioritization formula (impact ÷ effort with Low=1…Critical=4, S=1…XL=4, rounded to one decimal), and a complete register table template with per-column rules. This matches the fully-executable anchor covering the common cases.

5 / 5

Workflow Clarity

Each mode is a clearly sequenced workflow with explicit validation checkpoints: the zero-source-files and unresolved-code-root checks before scanning, register-existence checks before prioritize/report, match-before-appendting dedup checks, and approval gates before every write, each with a defined terminal verdict (COMPLETE/BLOCKED/FAIL/NOT ASSESSED). The batch scan and register writes are guarded by these verification steps, so the missing-validation cap does not apply.

5 / 5

Progressive Disclosure

The single file is well-organized with clearly signaled phases and the register-format spec inlined where every mode needs it, and external pointers (.claude/docs/automation-modes.md, code-root-resolution.md) are one level deep and named in place. There are no bundle reference files, and at ~200 lines some material (the ten-column register spec, or the per-mode prompts) could be split into a reference file, leaving it at good-structure-with-minor-gaps rather than the ideal split.

4 / 5

Total

18

/

20

Passed

Description

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

The description communicates a clear, multi-action capability in the technical-debt niche, but omits any 'when to use' trigger guidance and lacks the natural synonym coverage ('tech debt', 'code debt') users would most likely say. Adding an explicit Use-when clause with common phrasings would lift both completeness and trigger quality.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user mentions tech debt, technical debt, code debt, or asks to clean up TODO/FIXME comments or a refactoring backlog."

Include common synonyms and concrete indicator keywords (tech debt, TODO/FIXME/HACK, deprecated code, god files) so natural user phrasings match the description.

Briefly name the scan inputs (comment markers, duplication, oversized files/functions) to close the coverage gap in the action list.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Track, categorize and prioritize technical debt", "scans for debt indicators, maintains a register" — giving a clear picture of capability. It falls short of a 5 because coverage has minor gaps: the indicators scanned (TODO/FIXME/HACK/deprecated) and the reporting mode are not named, so the action list is not comprehensive.

4 / 5

Completeness

The 'what' is clearly stated (track, categorize, prioritize, scan, maintain a register), but there is no 'Use when...' clause or any equivalent explicit trigger guidance, capping completeness at 3 per the judging guidelines. It is not a 2 because the 'what' is concrete and multi-part, not vague.

3 / 5

Trigger Term Quality

"technical debt" is the key natural trigger, supplemented by "debt indicators" and "register", but common variations users would actually say — "tech debt", "code debt", "TODO/FIXME cleanup", "refactoring backlog" — are missing. This matches the anchor for some relevant keywords while missing common variations/synonyms, rather than the good-coverage anchor above it.

3 / 5

Distinctiveness Conflict Risk

"Technical debt" is a clear niche with distinct triggers (debt register, debt indicators), keeping conflict risk low. Minor overlap remains with closely related code-quality/review skills, so it does not fully meet the minimal-conflict bar of a 5.

4 / 5

Total

14

/

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
Donchitos/Claude-Code-Game-Studios
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.