CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

focused-fix

Use when the user asks to fix, debug, or make a specific feature/module/area work end-to-end. Triggers: 'make X work', 'fix the Y feature', 'the Z module is broken', 'focus on [area]'. Not for quick single-bug fixes — this is for systematic deep-dive repair across all files and dependencies.

69

Quality

87%

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

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

An exceptionally actionable, clearly sequenced repair protocol with real commands, templates, and validation loops throughout. Its main weakness is redundancy — three separate sections press the same 'don't skip phases' message — which inflates token cost without adding guidance.

Suggestions

Merge 'Red Flags', 'Common Rationalizations', and 'Anti-Patterns' into a single table; they repeat the same warnings (e.g., fixing before tracing dependencies appears in all three) and account for a large share of the token budget.

Trim dramatic filler such as 'Period.' and 'Violating the letter of these phases is violating the spirit of focused repair' — the imperative rules already carry the force.

Consider moving the risk-labeling criteria and anti-patterns tables to a references/ file linked from the body, keeping SKILL.md as a lean protocol overview and improving progressive disclosure.

DimensionReasoningScore

Conciseness

Mostly efficient prescription with little explanation of concepts Claude already knows, but three sections — 'Red Flags', 'Common Rationalizations', and 'Anti-Patterns' — repeatedly cover the same ground (e.g., 'Starting to fix code before mapping all dependencies' vs. "'I'll map dependencies after I fix the obvious stuff'"), and dramatic filler ('Period.', 'Violating the letter of these phases is violating the spirit') pads the prose. Not 2 because the bulk is genuinely useful process content, not fluff.

3 / 5

Actionability

Fully concrete, executable guidance: exact commands ('git log --oneline -20 -- <feature-path>'), grep patterns for 'process.env, import.meta.env, os.environ', checklists, explicit fix ordering, structured output templates, and a worked 'FIX #1' example. Nothing is left as vague direction.

5 / 5

Workflow Clarity

Five phases strictly sequenced with explicit validation checkpoints and feedback loops: 'After each fix, run the related test', 'If a fix breaks something else, STOP and re-evaluate (go back to DIAGNOSE)', a 3-strike escalation rule, and a full VERIFY phase covering consumer tests. Checklists and the Quick Reference table cap it off.

5 / 5

Progressive Disclosure

Well-organized single-file skill with clear section headers and a Quick Reference table for navigation; no bundle files exist, so all guidance is deliberately inline. Not 5 because at ~313 lines the overlapping caution sections and tables (risk labels, rationalizations, anti-patterns) are natural candidates for a one-level-deep reference file, and there is no progressive disclosure mechanism at all.

4 / 5

Total

17

/

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: explicit 'Use when...' with concrete natural triggers, a clear statement of what the skill does, and a sharp negative boundary separating it from single-bug debugging. Only minor improvements possible — a few common trigger synonyms and slightly fuller action coverage.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'fix, debug, or make a specific feature/module/area work end-to-end' and 'systematic deep-dive repair across all files and dependencies' — with only minor gaps (it does not enumerate the concrete sub-steps like dependency tracing or test verification). Not 3 because it goes beyond 1-2 generic actions; not 5 because coverage of what the skill actually does is less comprehensive than the trigger coverage.

4 / 5

Completeness

Explicitly answers both: what ('systematic deep-dive repair across all files and dependencies') and when ('Use when the user asks to fix, debug, or make a specific feature/module/area work end-to-end') with concrete trigger phrases, plus a negative boundary ('Not for quick single-bug fixes').

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'make X work', 'fix the Y feature', 'the Z module is broken', 'focus on [area]', plus synonyms fix/debug/repair/broken. Not 5 because a few common user phrasings are missing (e.g., 'X isn't working', 'X is failing', 'fix the auth').

4 / 5

Distinctiveness Conflict Risk

Clear niche — feature/module-level systematic repair — with distinct trigger phrasings and an explicit exclusion of quick single-bug fixes, minimizing conflict with general debugging skills.

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

alirezarezvani/claude-skills

Path

engineering/skills/focused-fix/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.