Content
66%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-engineered orchestration overview with exceptional gating, validation, and stop-condition logic, and mostly concrete tool-level guidance. Its two real weaknesses are density (invariant 1 inlines detail that belongs in reference files) and a broken bundle: nearly all phase, recipe, and hook files it points to are missing, while three unreferenced legacy reference files sit orphaned in references/.
Suggestions
Ship or remove the dangling references: the seven `phases/*.md` files, three `recipes/*.md` files, `hooks/repro-gate.sh`, and `providers/<mode>/` playbooks are all cited in the body but absent from the bundle — the phase table's 'Re-read the phase file on entry' instruction fails on every phase.
Link or delete the orphaned `references/` files (`dynamic-variables-debugging.md`, `phase-2-failure-collection.md`, `phase-3-diagnosis.md`): they are never mentioned in the body and use an older numbered-step framing that conflicts with the v3 capability-manifest model described here.
Split invariant 1's ~40-line nested paragraph into a short invariant statement in SKILL.md plus a reference file for the reproduction-mode sizing rules, hook mechanics, and gate_override record shape; also fix the Parameters section's mid-sentence line break ('...to verify. / Explicit user overrides').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Almost no space is wasted on concepts Claude already knows, but the body is dense to the point of being hard to parse: invariant 1 is a ~40-line nested wall of text inlining the hook mechanics, the full gate_override JSON shape, and the stochastic sizing formula, and the Parameters section has a formatting glitch ("...to verify.\nExplicit user overrides..."). Mostly efficient but several sections clearly could be tightened or pushed to reference files, which matches anchor 3 better than anchor 4. | 3 / 5 |
Actionability | Much of the guidance is concretely executable: the exact tool call (`mcp__cekura__cekura_skill_started` with literal `skill_name`, `verification_tag`, `plugin_version` values), the exact `repro.json` field list, the run-naming format `[selfimprove:<session_id>] <phase> — <detail>`, the formula `N = clamp(⌈2/p̂⌉, 4, 10)`, and explicit numeric defaults. Not a 5 because the actual per-phase execution steps are delegated to phase files rather than shown, and no sample manifest snippet or worked command example appears in the body itself. | 4 / 5 |
Workflow Clarity | The seven-phase table gives a clear numbered sequence with each phase's purpose, and validation checkpoints are unusually explicit: must-fail-first gate with artifact, readback attestation after every deploy, overfitting gate, budgets/stop conditions (oscillation, same failure shape 3×), "revert on any" regression damage, and a drift/failure classification table that tells the agent exactly when to stop. Feedback loops (fix → re-validate, flake retry policy, manifest repair pass) are present, matching anchor 5. | 5 / 5 |
Progressive Disclosure | Structure and signaling are well designed — a phase table, an on-demand reference section, clearly labeled recipes — but scored against the actual bundle the navigation is largely broken: `phases/setup.md`, `phases/collect.md`, `phases/debug.md`, `phases/reproduce.md`, `phases/loop.md`, `phases/regression.md`, `phases/promote.md`, all three `recipes/*.md`, `hooks/repro-gate.sh`, and `providers/<mode>/` playbooks do not exist; only `references/manifest.schema.json` and `references/manifest-guide.md` are present. Additionally, three orphaned files in `references/` (`dynamic-variables-debugging.md`, `phase-2-failure-collection.md`, `phase-3-diagnosis.md`) are never referenced from the body and appear to be from an older numbered-step version of the skill. Since the body instructs the agent to "re-read the phase file on entry", navigation fails in practice, which sits below anchor 3's 'references present but not clearly signaled'. | 2 / 5 |
Total | 14 / 20 Passed |