CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

orch-fix-defect

Orchestrate fixing a bug — reproduce it as a failing regression test, fix to green, review, and gated commit — by delegating each phase to the matching ECC agent. Use when existing behavior is broken or wrong.

Quality

88%

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

86%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 exemplary thin-wrapper skill: lean, well-structured, with explicit delegation targets, gates, and a built-in red-to-green validation loop. The only weakness is that key notation (phase mask, gates) is only fully defined in the linked engine skill, leaving minor gaps in standalone executability.

Suggestions

Expand the phase-mask line with a one-phrase legend (e.g. what phases 4/5/6 are) so the settings are executable without opening the engine skill.

State the failure-recovery expectation for the red-test step (what to do if the bug cannot be reproduced as a failing test) to complete the feedback loop.

DimensionReasoningScore

Conciseness

Roughly 40 lean lines with zero padding: no explanation of concepts Claude already knows, dense operational settings ("Phase mask: 0 → ... → 4 → 5 → 6"), and a compact one-line example. Every token earns its place.

5 / 5

Actionability

As an instruction-only orchestration skill, the guidance is specific: named delegate skills ("orch-pipeline", "code-explorer", "build-error-resolver", "/build-fix", "security-reviewer"), a defined first move ("reproduce the bug as a new failing test"), and a concrete example. Falls short of 5 because the phase-mask notation and gate semantics are only fully executable by reading the linked engine skill, and there is no copy-paste-ready invocation.

4 / 5

Workflow Clarity

A clear sequence is present (scope root cause → red test → fix to green → review → gated commit) with the red-to-green test acting as an explicit feedback loop and named checkpoints ("Stop at Gate 1 ... and Gate 2 (pre-commit)"). Anchor 5 requires full explicit validation steps and error-recovery loops, but the recovery paths ("escalate build breaks to build-error-resolver") are only partially specified, placing it between anchors 4 and 5, closer to 4.

4 / 5

Progressive Disclosure

Under 50 lines with no bundle files and well-organized sections (When to Use, Operation settings, How It Works, Example); per the rubric's simple-skill note this qualifies for a 5. The single reference to the shared engine ([orch-pipeline](../orch-pipeline/SKILL.md)) is clearly signaled and one level deep.

5 / 5

Total

18

/

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 in third-person voice with explicit what/when structure and concrete, sequenced actions. The main gap is limited synonym coverage for trigger terms (no "error", "crash", "regression") and no in-description disambiguation from sibling skills.

Suggestions

Broaden the 'Use when' clause with common synonyms, e.g. 'Use when existing behavior is broken or wrong — an error, crash, regression, or wrong output'.

Add a brief in-description distinction from siblings, e.g. '...not for behavior changes or new capabilities', to further reduce trigger overlap.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "reproduce it as a failing regression test, fix to green, review, and gated commit" — plus a concrete mechanism ("delegating each phase to the matching ECC agent"), covering the full fix workflow comprehensively.

5 / 5

Completeness

Explicitly answers what ("Orchestrate fixing a bug — reproduce it as a failing regression test, fix to green, review, and gated commit...") and when ("Use when existing behavior is broken or wrong") with a concrete trigger phrase, matching the anchor-5 example structure.

5 / 5

Trigger Term Quality

Natural terms "fixing a bug", "broken", "wrong", "existing behavior" are phrased as users would say them, but common synonyms like "error", "crash", "regression", or "not working" are missing. Anchor 5 requires comprehensive synonym coverage; anchor 4 (good coverage, a few natural terms missing) is the closest fit.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — fixing broken behavior, distinct from adding or changing features — and the ECC-agent framing is distinctive. However, the description itself does not distinguish fix-defect from sibling orchestration skills (that disambiguation lives only in the body), leaving minor overlap risk with any generic bug-fixing skill; that places it just below anchor 5.

4 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

relative_links

Relative link issues: 1 suspicious

Warning

Total

14

/

16

Passed

Repository

affaan-m/ECC

Path

skills/orch-fix-defect/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.