CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

coding

Handoff skill and bug-capture entry point: loads plan-context.md and all design artifacts, performs a critical review against the real codebase, and ensures continuous writeback to the artifacts during and after implementation. Also the entry point when a bug is reported outside of an active implementation run -- captures the FIX artefact (BACKLOG row + FIX detail file + branch) without forcing an immediate fix. Use this skill when the user mentions "implement", "code", "realize plan-context", "build feature", "Bug gefunden", "es gibt einen Fehler", "Fix erfassen", or similar, and either a plan-context.md / FEATURE spec exists OR a bug surfaced. This skill does NOT take over the coding workflow -- the Default Claude Code agent remains responsible for the actual implementation. This skill ensures the context is critically reviewed, cleanly handed off, and artifacts stay up to date.

Quality

82%

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

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

The body delivers an exceptionally rigorous, executable workflow with validation gates and feedback loops at every phase, and it does push some detail (subtypes, mid-course triggers) into clearly signaled one-level-deep references. However, at 869 lines it carries generic TDD/debugging methodology and heavily repeated FIX-artefact rules inline, and one bundle reference is orphaned behind a two-level chain, hurting token efficiency and navigation.

Suggestions

Move the Phase 3c debugging protocol and the Phase 3b TDD RED/GREEN/REFACTOR cycle into a reference file (e.g. references/debugging-protocol.md), keeping only the binding one-line rule and trigger conditions in SKILL.md; both restate methodology Claude already knows.

State the FIX artefact shape (BACKLOG row + FIX detail file at _devprocess/requirements/fixes/FIX-{ee}-{ff}-{nn}-{slug}.md + branch) once in a single normative section and have the bug-capture entry, Phase 3c, Phase 4c, and the hotfix lane point to it instead of restating it five times.

Link references/reachability-by-stack.md directly from the Phase 4a verification-gate table row (or fold the pointer into the SKILL.md text) so it is one level deep instead of only reachable via verification-gate-subtypes.md.

DimensionReasoningScore

Conciseness

The 869-line body includes sections that restate textbook knowledge Claude already has ("RED: Write a failing test", "GREEN: Write the minimal code to pass the test", and the generic debugging steps 'Read the error message completely', 'Check recent changes -- git diff'), and repeats the FIX artefact shape (BACKLOG row + detail file + branch) at least five times across the bug-capture entry, Phase 3c, the Writeback paragraph, Phase 4c, and the hotfix lane, plus four separate pointers to graph-invariants.md for the same rules. This matches anchor 2 ('noticeably verbose; several unnecessary explanations or padded sections') rather than anchor 3: this is more than 'could be tightened' -- the TDD/debug protocols and the repeated FIX-shape rules could move to reference files, roughly halving the body.

2 / 5

Actionability

Guidance is fully executable: copy-paste-ready commands ("python3 tools/github-integration/flow.py tag-phase --item <ID> --phase code"), exact file paths and templates ("_devprocess/requirements/fixes/FIX-{ee}-{ff}-{nn}-{slug}.md from templates/FIX-TEMPLATE.md"), literal commit message formats, marker syntax with per-language comment styles, and a concrete 6-step regression red-green cycle. This matches anchor 5 ('fully executable; copy-paste ready code or commands') with concrete coverage of the common cases; it is not anchor 4 because even edge paths (hotfix lane, no-plan-context fallback, METRICS.md seeding) carry exact commands or file locations rather than gaps.

5 / 5

Workflow Clarity

The phase sequence (Pre-Phase 0 -> Phase 0 triage -> 1 load -> 2 critical review -> 3 implementation -> 4 completion -> Handoff Ritual) is explicit with validation checkpoints and feedback loops throughout: the triage gate stops the skill "before the first Edit/Write/Bash call", the Coverage Gate blocks code while an item is open and re-runs when upstream artifacts change, the verification gate requires fresh evidence per claim, and the regression cycle proves the test catches the bug. This matches anchor 5 ('clear sequence with explicit validation steps; feedback loops for error recovery; checklists').

5 / 5

Progressive Disclosure

There is real reference usage ("references/verification-gate-subtypes.md", "references/mid-course-triggers.md" are clearly signaled and one level deep), but the 869-line body inlines substantial content that belongs in reference files (the full debugging protocol, the TDD RED/GREEN/REFACTOR cycle, the hotfix lane with its four safety nets), and the bundle's references/reachability-by-stack.md is never linked from SKILL.md -- it is only discoverable through a second-level hop via verification-gate-subtypes.md. This fits anchor 3 ('some structure but could be better organized ... content that should be separate is inline') better than anchor 4, where most content would be appropriately placed with only minor organization gaps.

3 / 5

Total

15

/

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: it explicitly covers both entry conditions with concrete artifact names, an explicit 'Use when' clause with natural (bilingual) trigger phrases, and a clear boundary statement against the default coding agent. The only weaknesses are a few missing common English trigger variations and the inherent genericness of 'code'/'implement' as trigger words.

DimensionReasoningScore

Specificity

Quotes like "loads plan-context.md and all design artifacts, performs a critical review against the real codebase, and ensures continuous writeback" and "captures the FIX artefact (BACKLOG row + FIX detail file + branch)" list multiple concrete actions with named files and comprehensive coverage of both entry conditions. It clearly exceeds anchor 4: the actions name specific artifacts (plan-context.md, BACKLOG row, FIX detail file, branch) rather than having minor gaps.

5 / 5

Completeness

Both questions are answered explicitly: the 'what' ("loads plan-context.md and all design artifacts, performs a critical review ... ensures continuous writeback", plus the bug-capture path) and the 'when' ("Use this skill when the user mentions ... and either a plan-context.md / FEATURE spec exists OR a bug surfaced"). This matches anchor 5's 'clearly and explicitly answers both what AND when with concrete trigger phrases'; it is not anchor 4 because the when-clause includes concrete trigger phrases plus an explicit precondition, leaving nothing merely implied.

5 / 5

Trigger Term Quality

"Use this skill when the user mentions 'implement', 'code', 'realize plan-context', 'build feature', 'Bug gefunden', 'es gibt einen Fehler', 'Fix erfassen'" gives good, natural trigger coverage across both English and German, matching anchor 4's 'good keyword coverage; a few natural terms missing'. Not anchor 5: common English variations like 'fix a bug', 'I found a bug', 'develop', or 'write code' are absent, and 'realize plan-context' is jargon-leaning rather than something a user would naturally say.

4 / 5

Distinctiveness Conflict Risk

The gating condition ("either a plan-context.md / FEATURE spec exists OR a bug surfaced") and the explicit boundary statement ("This skill does NOT take over the coding workflow -- the Default Claude Code agent remains responsible for the actual implementation") carve out a mostly distinct niche with minor overlap risk, matching anchor 4. It is not anchor 5 because the trigger words 'implement' and 'code' are extremely generic and would compete with any plain coding skill or agent in the same collection.

4 / 5

Total

18

/

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

skill_md_line_count

SKILL.md is long (870 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

salemaziel/digital-innovation-agents

Path

skills/coding/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.