Content
93%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 single-file rules skill: dense with non-obvious project contracts, fully executable validation commands, and a documented past failure mode with its exact cause and fix. The only gap is that the editing workflow is conveyed through a rules-plus-validation structure rather than an explicitly sequenced procedure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every rule is repo-specific contract knowledge Claude could not already know ('Mutate board state through `setCell(x, z, opts)`', 'Keep Three.js pinned to r185 and self-hosted under `vendor/three/`'), with no general-concept padding; even the Cluso parenthetical earns its place by preventing rule reversal. | 5 / 5 |
Actionability | Copy-paste-ready commands throughout: `npm test`, `npm run build`, `npm run vendor:three`, a working perl + `node --check` extraction pipeline, a browser validation URL, and the check.js regex with concrete ✓/✗ HTML examples covering the common failure case. | 5 / 5 |
Workflow Clarity | An explicit Validation section with runnable commands and a stale-build diagnostic loop ('If browser stack traces point at ... run `npm run build`') provides real checkpoints, but the edit → test → browser-check sequence is implied by section order rather than laid out as an explicit workflow with fix/retry steps, so it falls short of the top anchor. | 4 / 5 |
Progressive Disclosure | A compact (~56 line) single-file skill with clean sections (Core rules, Validation, script gotcha, Related durable systems) and one-level-deep, clearly-signaled deferrals to `.codex/skills/tinyworld-runtime-state` and `.codex/skills/tinyworld-island-and-planes`; no bundle files exist or are needed. | 5 / 5 |
Total | 19 / 20 Passed |