CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ce-debug

Diagnosis loop for bugs and failing behavior. Use when asked to debug or fix failing or slow behavior.

Quality

82%

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

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.

A dense, well-orchestrated multi-mode workflow: phases, gates, exact status enums, and guarded handoff routing are all concrete and executable, with validation and escalation loops stated in the body and detail correctly pushed into real, clearly-signaled reference files. The only structural nit is a handful of reference files hidden behind second-level references rather than listed in the overview, plus minor repetition of mode policy across sections.

DimensionReasoningScore

Conciseness

The body never explains concepts Claude already knows (no 'what is git' or debugging tutorials) and every section carries skill-specific policy — exact enums, gates, and file:line-evidence rules — so it sits at 'Efficient; minor instances of over-explanation that could be trimmed'. Not a 5 because some policy repeats (the convergent/divergent rule and the exact-spelling warning each appear in both the Mode section and Phases 2/4, and the 'Two facts make it less obvious than it looks' handoff prose could be tightened); not a 3 because there is no genuinely unnecessary explanation.

4 / 5

Actionability

Guidance is fully executable for an instruction-only skill: exact commands (`git checkout -b <name>`, `git rev-parse --show-toplevel`, `git status --short`, `git rev-parse --abbrev-ref origin/HEAD` with the `origin/`-strip detail), a copy-paste Debug Summary template, closed status enums (`fixed-and-pushed | fixed-not-pushed | ...`), and precise invocation instructions (`ce-commit-push-pr` with `branding:on`). Matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'; the few deliberately flexible points ('match by capability, not by a host-specific name', 'Establish those however fits the repo') are explicitly justified portability, not vagueness.

5 / 5

Workflow Clarity

Five phases are explicitly sequenced ('0 Triage -> 1 Investigate -> 2 Root Cause -> 3 Fix -> 4 Handoff') with explicit validation checkpoints (the causal-chain gate with no-gap evidence and file:line references, the same-turn findings-before-question rule, the pre-fix scope record, the branch/default-branch check) and feedback loops for error recovery (escalation after 2-3 exhausted hypotheses or 3 failed fixes, the failed-fix rule in fix.md, re-validation via red-then-green testing). Matches the top anchor 'Clear sequence with explicit validation steps; feedback loops for error recovery'; the outward-facing commit/push/PR steps are additionally guarded by the offered-vs-pushed and fix-owned-file checks.

5 / 5

Progressive Disclosure

The 122-line body is a genuine overview: it defers Phases 0-2 to `references/investigate.md`, fixes to `references/fix.md`, and each non-interactive mode and the post-fix handoff to their own files, every one a real file in the bundle and each read signaled with when it applies ('Read `references/fix.md` before editing any file'). Not a 5 because the structure is not strictly one level deep — `anti-patterns.md`, `investigation-techniques.md`, and `defense-in-depth.md` are reachable only through second-level references from other reference files and are never surfaced in the overview — matching 'Good structure; most content is appropriately placed; references mostly clear; minor organization gaps'.

4 / 5

Total

18

/

20

Passed

Description

70%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 tight, correctly structured description with an explicit 'Use when' trigger clause and natural keywords, written in third person with no fluff. Its main limitation is that the capability statement covers only the diagnosis half of the skill, leaving fixing, regression testing, and handoff implicit.

Suggestions

Expand the capability statement to name the other concrete actions the skill performs, e.g. 'Diagnoses bugs by reproducing and tracing failures to a root cause, then fixes them test-first and hands off a commit or PR.'

Add common trigger synonyms users say for this task — 'broken', 'error', 'crash', 'test failure', 'regression' — to the 'Use when' clause to improve trigger recall.

Mention the pipeline/non-interactive variants (issue references, CI log tails) only if they broaden natural triggers; otherwise keep the description focused on the interactive debugging vocabulary.

DimensionReasoningScore

Specificity

"Diagnosis loop for bugs and failing behavior" names the domain and one concrete action (diagnosing bugs), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' — it omits the skill's other capabilities (fixing with test-first discipline, handoff/PR routing). Not a 4 because it does not list several specific actions, and not a 2 because 'diagnosis loop' is a concrete activity, not purely generic language.

3 / 5

Completeness

Both parts are present: the 'what' ("Diagnosis loop for bugs and failing behavior") and an explicit 'when' clause ("Use when asked to debug or fix failing or slow behavior") with concrete trigger phrases. It falls short of the 5 anchor because the 'what' under-describes the skill — the fixing, regression-test, and handoff halves of the workflow are absent from the capability statement — while exceeding the 3 anchor's 'when is missing or only weakly implied'.

4 / 5

Trigger Term Quality

"Use when asked to debug or fix failing or slow behavior" plus "bugs" gives good natural coverage — 'debug', 'fix', 'failing', 'slow' are phrases users actually say — but common synonyms like 'broken', 'error', 'crash', 'exception', or 'test failure' are missing, which is exactly the 'good keyword coverage; a few natural terms missing' anchor. Not a 5 for the missing synonyms; not a 3 because far more than a single domain keyword is present.

4 / 5

Distinctiveness Conflict Risk

The trigger "debug or fix failing or slow behavior" carves a clear debugging niche with minimal overlap risk, though it can mildly collide with closely related skills for running tests, fixing CI, or code review. Matches 'Mostly distinct; minor overlap risk with closely related skills'; not a 5 because adjacent fix/test skills share some of its trigger vocabulary.

4 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

EveryInc/compound-engineering-plugin

Path

skills/ce-debug/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.