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

The canonical home for this skill is focused-fix in alirezarezvani/claude-skills

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 and well-sequenced protocol skill: concrete commands, per-phase output templates, checklists, feedback loops, and an explicit escalation rule make the workflow nearly impossible to execute incorrectly. The main cost is token efficiency — roughly a third of the body is three-way redundant reinforcement of the same discipline, and moving the templates/catalogs to reference files would tighten it considerably.

Suggestions

Merge the 'Red Flags', 'Common Rationalizations', and 'Anti-Patterns' sections into a single table — all three restate 'don't skip phases / don't fix prematurely' and together consume ~70 lines that could be ~20.

Replace the two graphviz digraphs with a one-line arrow chain (SCOPE → TRACE → DIAGNOSE → FIX → VERIFY, with FIX→DIAGNOSE on regression and FIX→ESCALATE at 3 strikes); the diagrams restate information already in the prose and headings.

Move the per-phase output templates (FEATURE SCOPE, DEPENDENCY MAP, DIAGNOSIS REPORT, FIX log, completion report) to a references/output-templates.md file linked from each phase, keeping SKILL.md as a lean overview per progressive disclosure.

DimensionReasoningScore

Conciseness

The 5-phase protocol itself is dense and assumes Claude's competence with no basic-concept padding, but three sections — "Red Flags" (8 bullets), "Common Rationalizations" (8 rows), and "Anti-Patterns" (8 rows) — each restate "don't skip phases / don't fix prematurely" in different clothes, and the two graphviz diagrams largely duplicate the prose ordering. Mostly efficient but could be tightened by merging the overlapping catalogs — anchor 3, not 2, since no section explains concepts Claude already knows and each catalog carries distinct framing.

3 / 5

Actionability

Fully executable guidance throughout: exact commands ("git log --oneline -20 -- <feature-path>"), concrete grep targets (process.env, import.meta.env), filled output templates for every phase, a risk-labeling table with explicit criteria, exact fix ordering (deps → types → logic → tests → integration), and a literal escalation message to deliver verbatim. Copy-paste-ready templates cover the common cases — anchor 5.

5 / 5

Workflow Clarity

Strict 5-phase sequence (SCOPE → TRACE → DIAGNOSE → FIX → VERIFY) with explicit validation checkpoints (run the related test after each fix, verify consumer tests in Phase 5), explicit feedback loops (FIX → DIAGNOSE on regression, 3-strike escalation to architecture discussion), and per-category checklists in Phase 3. Exact match for anchor 5; verification is thorough so no cap applies.

5 / 5

Progressive Disclosure

No bundle files exist, so the skill is single-file by design; sections are clearly headed and a Quick Reference table aids navigation. However ~315 lines are all inline — the phase output templates and the three overlap-heavy catalogs (Red Flags / Rationalizations / Anti-Patterns) are content that could be split into reference files. Good structure with minor organization gaps — anchor 4, not 5, since content that could be separate is inline.

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 trigger phrases in natural user language, a clear what/when pair, and an explicit exclusion boundary that prevents overlap with single-bug debugging skills. The only weakness is that the capability list could enumerate the skill's distinctive phases (scoping, tracing, diagnosis) rather than generic repair verbs.

DimensionReasoningScore

Specificity

Lists several specific actions — "fix, debug, or make a specific feature/module/area work end-to-end" and "systematic deep-dive repair across all files and dependencies" — but omits the skill's distinctive sub-capabilities (scope mapping, dependency tracing, verification). Fits anchor 4 (several specific actions, minor gaps) rather than 3, since more than 1-2 concrete actions are named.

4 / 5

Completeness

Explicitly answers both questions: "Use when the user asks to fix, debug, or make a specific feature/module/area work end-to-end" (when, with concrete trigger phrases) and "systematic deep-dive repair across all files and dependencies" (what), plus an explicit exclusion boundary ("Not for quick single-bug fixes"). Third-person voice, no fluff — matches the anchor-5 example pattern.

5 / 5

Trigger Term Quality

Explicit trigger phrases ("make X work", "fix the Y feature", "the Z module is broken", "focus on [area]") are natural user language, giving good keyword coverage. Common variations like "X isn't working" or "why is Y broken" are missing, so it falls short of the comprehensive-synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

"Not for quick single-bug fixes" explicitly distinguishes it from generic debugging skills, and the niche (whole-feature systematic repair vs. single-bug debugging) has distinct, unambiguous triggers. Clear niche with minimal conflict risk — anchor 5.

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

.gemini/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.