Content
96%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.
An exemplary operational skill: fully executable commands, a gated workflow with real validation checkpoints, and lean product-specific detail with zero padding. The only structural improvement is moving the detailed QA scenario scripts into a referenced file so SKILL.md stays a tighter overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is imperative and dense with no explanations of concepts Claude already knows; even the 'why' passages are project-specific hazards Claude couldn't know ('poisons the kernel's code-signature cache for the inode, and later execs hang until reboot'). Every token carries an operating instruction or a real constraint. | 5 / 5 |
Actionability | Copy-paste-ready commands throughout: the stamped build invocation with CODEWHALE_BUILD_SHA, 'scripts/release/install-dogfood.sh', the fresh-shell check "zsh -lc 'type -a codew codewhale; codew --version'", and the app-server smoke commands. The only placeholder (--model <model>) is inherently variable and justified. | 5 / 5 |
Workflow Clarity | Seven numbered steps with explicit validation checkpoints: 'Never install an ungated build', the installer refusing unstamped/dirty trees, and the fresh-shell SHA check guarding against the 'classic false pass'. Error-recovery paths are present (deliberate CODEWHALE_ALLOW_DIRTY_DOGFOOD=1 override with disclosure, 'attach logs if the freeze reproduces'), plus a red-flags checklist. | 5 / 5 |
Progressive Disclosure | Well-organized sections (When to use / Workflow / Red flags / Output) with clearly signaled one-level-deep links (docs/RELEASE_CHECKLIST.md, crates/tui/AGENTS.md, docs/MOTION_CONTRACT.md, sibling skills). The inline scenario scripts (e.g. the issue-numbered #3289 Windows Terminal replay procedure) are heavy inline content that could be split into a reference file, which keeps this below a 5. | 4 / 5 |
Total | 19 / 20 Passed |