CtrlK
BlogDocsLog inGet started
Tessl Logo

techdebt

Technical debt detection and remediation. Run at session end to find duplicated code, dead imports, security issues, and complexity hotspots. Triggers: 'find tech debt', 'scan for issues', 'check code quality', 'wrap up session', 'ready to commit', 'before merge', 'code review prep'. Always uses parallel subagents for fast analysis.

74

1.35x
Quality

63%

Does it follow best practices?

Impact

87%

1.35x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./data/skills-md/0xdarkmatter/claude-mods/techdebt/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

92%

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

This is a strong skill description that clearly articulates specific capabilities (duplicated code, dead imports, security issues, complexity hotspots) and provides explicit trigger terms covering multiple natural user phrases. The main weakness is potential overlap with other code quality or security-focused skills due to the breadth of its scope. The description uses proper third-person voice and is concise yet comprehensive.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'find duplicated code, dead imports, security issues, and complexity hotspots.' Also mentions parallel subagents for fast analysis, adding implementation detail.

3 / 3

Completeness

Clearly answers both 'what' (technical debt detection and remediation—duplicated code, dead imports, security issues, complexity hotspots) and 'when' (session end, before merge, code review prep, with explicit trigger phrases listed).

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'find tech debt', 'scan for issues', 'check code quality', 'wrap up session', 'ready to commit', 'before merge', 'code review prep'. These are realistic phrases users would naturally use.

3 / 3

Distinctiveness Conflict Risk

While the specific triggers like 'find tech debt' and 'complexity hotspots' are distinctive, terms like 'check code quality', 'code review prep', and 'security issues' could overlap with linting skills, security scanning skills, or general code review skills. The scope is broad enough to potentially conflict with more focused tools.

2 / 3

Total

11

/

12

Passed

Implementation

35%

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

This skill has a well-conceived architecture and clear workflow structure, but suffers significantly from verbosity—it includes extensive tables, templates, and explanations of concepts Claude already understands (security patterns, complexity metrics, dead code detection). The actionability is undermined by aspirational commands and placeholder templates rather than truly executable code. Much of the content (detection patterns, language support, integration patterns) should be moved to referenced files to respect token budget.

Suggestions

Reduce the main file to ~80-100 lines by moving detection patterns, language support, integration patterns, and advanced usage into separate referenced files (e.g., references/detection-patterns.md, references/integration.md)

Remove explanations of well-known concepts (what SQL injection is, what cyclomatic complexity measures, what dead code is) and instead just list the thresholds and patterns to detect

Add explicit validation steps: verify subagent completion, validate auto-fix results by running tests or linting after changes, and add error recovery for missing tools

Provide actual executable subagent spawning code or Claude API calls rather than architectural diagrams and placeholder templates

DimensionReasoningScore

Conciseness

This skill is extremely verbose at ~350+ lines. It explains concepts Claude already knows (what cyclomatic complexity is, what dead code is, what SQL injection is), includes extensive tables of well-known patterns, and provides lengthy report templates, CI/CD configs, and troubleshooting sections that bloat the context window significantly. Much of this could be in referenced files or omitted entirely.

1 / 3

Actionability

While the skill provides concrete CLI commands and report templates, the actual implementation is aspirational rather than executable. Commands like `/techdebt --deep` and tools like `ast-grep` are referenced but there's no actual code that orchestrates the subagent spawning, no real scripts to run, and the subagent instruction template is a placeholder. The pre-commit hook references a non-existent `claude skill techdebt` command.

2 / 3

Workflow Clarity

The 5-step workflow is clearly sequenced and well-organized, but validation checkpoints are weak. There's no explicit verification that subagents completed successfully, no error handling for when tools are missing, and the auto-fix mode lacks a validation step after applying changes to confirm nothing broke. The safety rules for auto-fix are good but insufficient as a feedback loop.

2 / 3

Progressive Disclosure

The skill references external files (references/patterns.md, references/severity-guide.md) which is good, but the main file itself is a monolithic wall containing detection patterns, language support tables, integration patterns, advanced usage, troubleshooting, and best practices that should be split into separate reference files. The Quick Start section is well-placed but the body contains far too much inline detail.

2 / 3

Total

7

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
NeverSight/skills_feed
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.