Content
86%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 an exemplary progressive-disclosure router: lean, unambiguous path selection with trigger phrases, a Done contract including failure handling, and privacy rules, all deferring executable detail to real one-level-deep references. The only residual gaps are that the executable analyzer command and output-format examples are entirely delegated to the reference files rather than surfaced even briefly.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 28-line body is pure routing, outcome contract, and privacy rules with zero padding; the single background sentence ("the consumption side of Riffrec, a capture tool that records synchronized screen + voice + event sessions") is non-obvious domain knowledge Claude does not have, so every token earns its place. | 5 / 5 |
Actionability | Routing criteria are concrete and executable ("under ~60 seconds", "quick", "small", "just transcribe", exact reference file per route) and the Common rules give specific commit/local-only instructions. As an instruction-only skill the absence of inline code is acceptable per the scoring notes, but the executable analyzer invocation lives one reference deep and the body gives no example of the handoff output, leaving minor gaps versus fully copy-paste-ready guidance. | 4 / 5 |
Workflow Clarity | The sequence is clear (route from input -> read only the named references -> defined Done outcome per path) with an explicit ambiguity checkpoint ("inspect the recording length and event count before choosing... ask the user") and a failure checkpoint ("ends with an actionable blocker rather than a partial success claim"). The detailed validation/feedback loops for the analysis steps themselves are deferred to references, which keeps it at anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | The body is a clean overview that routes to one-level-deep references by path with explicit loading discipline ("Read only the references named for that route; do not load the other path references"); all five named reference files exist in the bundle, and the bundled script scripts/analyze_riffrec_zip.py is reached one level deep via references/analyzer.md with a concrete invocation. | 5 / 5 |
Total | 18 / 20 Passed |