CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

he-fix-bugs

Debug and repair validated Harness Engineering defects with bounded scope, reproduction evidence, root-cause notes, regression protection, and validation proof. Use when a bug is already evidenced and the fix should not expand into broad improvement work.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured, disciplined instruction-only skill with an explicit fail-fast validation loop and clear handoff boundaries. Main deductions are a duplicate step number in the Procedure, some cross-section redundancy, and reference paths that dangle relative to the shipped bundle.

Suggestions

Fix the duplicate step numbering in Procedure (two consecutive steps are both numbered 6, lines 63 and 65) so the sequence reads 1-8 without ambiguity.

Verify or repair the out-of-package reference paths (../../references/*.md and Plugins/harness-engineering/references/deferred-context-index.md) so every cited contract resolves from the skill directory, and link the unmentioned references/task-profile.json or remove it.

Merge the overlapping Outputs and Output Format sections and deduplicate side-effect classification between Preconditions and Safety Boundaries to tighten token efficiency.

DimensionReasoningScore

Conciseness

The body is dense and directive with no concept explanations Claude already knows (e.g., "Prove the failure before fixing it", "A failing label is not a reproduction"). It falls short of anchor 5 due to redundancy across sections: side-effect classes appear in both Preconditions and Safety Boundaries, and Outputs overlaps Output Format ("Use concise sections: Reproduction, Root Cause, Patch, Validation..." restates the Outputs field list).

4 / 5

Actionability

For an instruction-only skill the guidance is largely concrete: named validation gates ("run strict audit, OpenClaw, OpenAI format lint, progressive disclosure lint, Plugin Eval"), exact output fields ("schema_version: 1", "pass|fail|blocked"), and a numbered procedure with specific directives like "Add or name regression protection that would fail before the fix and pass after it". It is not anchor 5 because several steps defer to contracts whose execution details are not in the bundle ("Apply the git staging contract", "Apply the visual reference contract"), leaving minor gaps in copy-paste executability.

4 / 5

Workflow Clarity

The Procedure is a clear 1-8 sequence with explicit validation checkpoints and a fail-fast feedback loop ("stop at the first failed gate, classify it, fix or block it, then rerun before broader validation"), which satisfies the validation requirement for mutation-class operations. It misses anchor 5 due to a sequencing defect — two steps are both numbered 6 (the git staging step and the media-storage step) — and some steps are conditional abstractions ("Apply the visual reference contract when...") rather than fully specified actions.

4 / 5

Progressive Disclosure

SKILL.md is a lean overview with a dedicated, purpose-labeled References section ("Contract and eval routing: references/contract.yaml, references/evals.yaml" — both files exist in the bundle), and the Stage Arc Boundary section clearly signals when to load its contract. Scored against the actual bundle structure it is not anchor 5 because four of the six reference entries (../../references/stage-arc-boundary-contract.md, ../../references/subagent-call-contract.md, ../../references/visual-reference-contract.md, and Plugins/harness-engineering/references/deferred-context-index.md) do not resolve within this package, and references/task-profile.json exists but is never linked.

4 / 5

Total

16

/

20

Passed

Description

88%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: third-person, concise, with explicit what and when clauses and multiple concrete capability statements. Trigger coverage is good but could add common user phrasings like 'failing test' or 'stack trace'.

Suggestions

Add natural trigger synonyms such as 'failing test', 'stack trace', or 'CI failure' to the 'Use when' clause to broaden natural-language matching.

Consider naming the artifact types users reference (e.g., 'issue', 'incident', 'regression report') to further reduce overlap with generic debugging skills.

DimensionReasoningScore

Specificity

"Debug and repair validated Harness Engineering defects with bounded scope, reproduction evidence, root-cause notes, regression protection, and validation proof" lists multiple concrete actions covering the full fix workflow (debug, repair, reproduce, root-cause, regression protection, validation) with comprehensive coverage. It exceeds anchor 4 because the action list spans the entire defect-repair lifecycle, not just several actions with gaps.

5 / 5

Completeness

Clearly answers both questions: what ("Debug and repair validated Harness Engineering defects with bounded scope, reproduction evidence, root-cause notes, regression protection, and validation proof") and when ("Use when a bug is already evidenced and the fix should not expand into broad improvement work") with a concrete trigger phrase. This matches anchor 5 exactly; anchor 4 would require the 'when' clause to be less explicit.

5 / 5

Trigger Term Quality

Natural terms present: "bug", "debug", "fix", "repair", "defects", "regression", plus an explicit "Use when a bug is already evidenced" trigger clause. It falls short of anchor 5 because common user phrasings like "failing test", "stack trace", "error", "broken", or "CI failure" are absent (they appear only in the body, not the description).

4 / 5

Distinctiveness Conflict Risk

The "Harness Engineering" domain qualifier plus "when a bug is already evidenced and the fix should not expand into broad improvement work" carves a clear niche and actively steers away from broad improvement work. It sits at anchor 4 rather than 5 because 'debug and repair bugs' overlaps generic debugging/diagnosis skills in the same family, and the HE qualifier alone is what disambiguates them.

4 / 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

jscraik/Agent-Skills

Path

Plugins/harness-engineering/skills/he-fix-bugs/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.