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.
The body is lean, highly actionable, and well-sequenced with validation checkpoints and recovery flows. Its only weakness is progressive disclosure: the References section names files that are not actually shipped in the bundle, so a downstream reader hits dead links.
Suggestions
Ship the referenced bundle files (resources/voice-matrix.md, prompt-tips.md, execution-protocol.md, checklist.md, and config/voice-config.yaml) or remove their links so navigation is end-to-end valid.
Add a one-line note next to each reference indicating what it covers (e.g., "engine matrix: pick Kokoro/Piper by language and footprint") so a reader can decide whether to load it without opening the file.
Treat "verified against Voicebox 0.5.0" as a versioned anchor and add a short note on what to re-verify when Voicebox's MCP tool surface changes, so the version pin does not silently go stale.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and table-driven, assumes Claude knows MCP/HTTP/audio concepts, and avoids explaining what TTS or a voice profile is; minor restatements between the canonical command path and the per-tool notes do not rise to over-explanation. | 5 / 5 |
Actionability | Fully executable guidance with real tool names and parameter shapes ("MCP voicebox_speak { text, profile, language?, engine?, personality? }"), exact endpoints ("GET http://127.0.0.1:17493/audio/{generation_id}"), a concrete MCP registration command, and copy-paste invocation examples covering the common TTS/STT/notification cases. | 5 / 5 |
Workflow Clarity | A clear PREPARE→ACQUIRE→ACT→VERIFY→FINALIZE sequence carries explicit validation (VERIFY scene, manifest-field checks, 5000-char/30-min checkpoints, exit codes) and a feedback loop (MCP tool-name drift → re-run tools/list and update the cache); the destructive/batch cap does not apply since outputs write to fresh timestamped directories. | 5 / 5 |
Progressive Disclosure | A dedicated, well-signaled, one-level-deep References section (resources/voice-matrix.md, prompt-tips.md, execution-protocol.md, checklist.md, config/voice-config.yaml) gives good structure with no inlined bulk or nested chains, but the referenced files are absent from the bundle on disk — a minor navigation gap that keeps it off the top anchor. | 4 / 5 |
Total | 19 / 20 Passed |