CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fix-plan-blast-radius

Plan the smallest correct fix at the right trust boundary, listing siblings, callers, adjacent journeys, contract changes, data impact, rollback, and approvals before writing code. Use for every non-trivial fix and always for security, payment, auth, or data bugs.

71

Quality

89%

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

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.

An exceptionally lean, dense instruction skill: every numbered step carries concrete, environment-specific guidance and the exit criteria provide an explicit completion checkpoint. The main gaps are delegated mechanics (sibling search) that are assumed rather than specified, and a template reference that is not shipped in the bundle.

Suggestions

Ship or inline `templates/fix-plan.md` — the body's core instruction depends on it, but the file is absent from the bundle, leaving the skill's primary artifact unresolvable.

Add a one-line hint of how to sweep for sibling instances (e.g., the concrete search pattern or command that `fix-class-sweep` uses) so step 3 is executable without the other skill loaded.

DimensionReasoningScore

Conciseness

The 22-line body is dense with guidance and assumes Claude's competence; the only anecdote ("In our lab an allow-list serializer silently dropped `owner` and broke a journey") is one line of environment-specific knowledge Claude could not have, so it earns its place. No padding or explanations of known concepts.

5 / 5

Actionability

Concrete guidance throughout: layer-to-concern mapping ("server for access, payments, and validation; template for rendering; job for async"), named helpers (`requireOwner`, `safePath`, `parsePublicUrl`, `toPublic`), and a hard decision rule ("Customer-visible or policy change? Then NEEDS-PRODUCT-DECISION"). Not a 5: item 3 delegates sibling-search mechanics entirely to `fix-class-sweep` without a hint of how, and items 7/9 are bare prompts with no concrete method.

4 / 5

Workflow Clarity

A clearly sequenced 9-step fill procedure capped by an explicit "## Exit criteria" section ("The plan is complete, and approvals are requested in one batch if needed") serving as the completion checkpoint. This is a single-task, under-50-line planning skill with no destructive or batch operation, so the simple-skill exception applies and the sequence is unambiguous.

5 / 5

Progressive Disclosure

Well-organized short body with clear sections, appropriate for an under-50-line skill. Not a 5: the body's central instruction "Fill `templates/fix-plan.md`" points at a file that does not exist in the bundle (no references/, scripts/, assets/, or templates/ directories are present), leaving the primary artifact unresolvable; the cross-skill pointers (`fix-class-sweep`, `qa-recon-risk-map`) are also unverifiable within the bundle.

4 / 5

Total

18

/

20

Passed

Description

85%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 dense, third-person description that clearly states both capability and triggers, enumerating concrete planning artifacts. Its main weakness is the aggressive 'every non-trivial fix' trigger, which invites conflicts with adjacent fix/debug skills, and somewhat narrow trigger vocabulary.

Suggestions

Narrow the trigger scope (e.g., 'Use when planning fixes that touch security, payment, auth, or data paths, or when a bug's blast radius is unclear') to reduce conflict with general debugging and code-fix skills.

Add one or two natural synonyms to the trigger clause, such as 'vulnerability' or 'hotfix', so users' actual phrasing matches more readily.

DimensionReasoningScore

Specificity

"Plan the smallest correct fix at the right trust boundary, listing siblings, callers, adjacent journeys, contract changes, data impact, rollback, and approvals before writing code" names multiple specific concrete actions covering the entire fix-planning lifecycle, matching the comprehensive-coverage anchor. Not a 4: the action list has no notable coverage gaps across scoping, impact, rollback, and approvals.

5 / 5

Completeness

Explicitly answers what ("Plan the smallest correct fix... listing siblings, callers, adjacent journeys, contract changes, data impact, rollback, and approvals") and when ("Use for every non-trivial fix and always for security, payment, auth, or data bugs") with concrete trigger phrases. Not a 4: the 'when' clause is explicit and enumerated, not merely present-but-vague.

5 / 5

Trigger Term Quality

Natural terms users would say are present: "fix", "non-trivial fix", "security, payment, auth, or data bugs". Not a 3: coverage goes beyond a couple of generic keywords; not a 5: common synonyms users might say ("vulnerability", "hotfix", "patch", "regression") are absent.

4 / 5

Distinctiveness Conflict Risk

The fix-planning/blast-radius niche itself is distinct, but "Use for every non-trivial fix" claims virtually any bug-fix session, overlapping heavily with general debugging, code-review, and fix-execution skills. Anchor 3 fits (somewhat specific but could still overlap with similar skills); not a 4 because the trigger's breadth creates more than minor overlap risk.

3 / 5

Total

17

/

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

itsablabla/qa-bug-agent-skills

Path

skills/fix-plan-blast-radius/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.