Content
100%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 instruction/config skill body: lean, dense with non-obvious project-specific policy, and fully actionable via exact values and commands. Multi-step release and rollback workflows are explicitly sequenced with verification checkpoints and an error-recovery loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~35-line body is dense with project-specific rules Claude could not derive elsewhere — 'Precedence: `.env` (committed defaults) → `.env.local` (git-ignored) → ...', 'always `--frozen-lockfile` in CI', the full Cache-Control table — with zero padding or explanation of concepts Claude already knows. Every token earns its place. | 5 / 5 |
Actionability | Guidance is copy-paste ready: exact header values ('public, max-age=31536000, immutable'), an executable verification command ('curl -sI https://example.com | grep -E 'HTTP|Strict''), a concrete auth rule ('return 401 unless the `authorization` header equals `Bearer ${process.env.CRON_SECRET}`'), and specific rollback mechanics ('git revert', on a branch). Common cases are covered with concrete values rather than vague direction. | 5 / 5 |
Workflow Clarity | Sequences are explicit and ordered: CI 'Stages in order: install → lint → test → production build → deploy', release gated on 'lint + test + build all exiting 0 and no draft PRs', and rollback has a defined error-recovery path ('rolled back immediately, not patched forward: ... platform's instant rollback ... first, then a revert PR') with a re-validation loop ('Re-run the `curl -sI` check before calling it resolved'). Validation checkpoints are explicit for the risky release/rollback operations, so no cap applies. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines with no bundle files (references/, scripts/, assets/ are absent) and no need for them; it is a well-organized overview with clear sections. Its external pointers are one level deep and clearly signaled: the project doc ('See `.opencastle/stack/deployment-config.md`, when the project has one') and cross-skill handoffs ('Load **security-hardening** skill', 'the **technical-writing** format'). | 5 / 5 |
Total | 20 / 20 Passed |