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 single-file skill body: fully executable commands, a phased workflow with real validation gates and conflict-recovery feedback loops, and near-zero token waste. The only structural nit is inline cross-skill API detail in the Signal integration section that could be moved to a reference file as the skill grows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: it contains no conceptual explanations, only commands and channel-specific facts Claude could not know (marker mappings, the upstream remote, merge branch, and the exact test count). Every token earns its place, matching the lean-and-efficient anchor. | 5 / 5 |
Actionability | Fully executable throughout: copy-paste bash/git/npm commands for every step, a concrete spot-check prompt that elicits formatted output, a TypeScript import example for the Signal integration, and both macOS (launchctl) and Linux (systemctl) restart variants. This matches the copy-paste-ready anchor at 5. | 5 / 5 |
Workflow Clarity | The three-phase sequence is explicit with strong checkpoints: an idempotency pre-flight ('test -f src/text-styles.ts'), a validation gate ('All 73 tests should pass and the build should be clean before continuing'), merge-conflict recovery guidance, and a verify phase with rebuild, live spot-check, and log inspection. This matches the clear-sequence-with-explicit-validation and error-recovery anchor at 5. | 5 / 5 |
Progressive Disclosure | Sections are clearly organized with no external files needed, and each phase is well signaled. The minor gap keeping it below 5 is that the Signal Skill Integration section inlines API-reference detail (the return shape and the signal-cli '"start:length:STYLE"' JSON-RPC parameter format) for another skill's consumption — content that would sit better in a signaled reference file if the bundle grows. It is well above the some-structure level of 3. | 4 / 5 |
Total | 19 / 20 Passed |