Content
73%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.
A well-engineered, highly actionable skill body: exact endpoints, tool signatures, guardrails, and a validated workflow with recovery paths. Its main weakness is redundancy — key limits and rules are restated across Expected inputs, Transitions, the failure table, and Guardrails, which inflates token cost without adding information.
Suggestions
State each operational limit (5000-char TTS cap, 30-minute STT cap, profile-required-for-TTS, SIGINT handling) once in the Guardrails section and reference it from the failure table and Expected inputs instead of repeating the full rule in each place.
Move the "Notes on voicebox_speak / voicebox_transcribe" parameter details and the Guardrail 8 manifest field specification into a reference file (e.g., resources/execution-protocol.md), keeping only the tool names and required fields in SKILL.md.
Include one concrete manifest.json example and a representative ffmpeg command for the processing mode (or an explicit pointer to the exact section of resources/audio-processing.md) so the processing path is as copy-paste ready as the Voicebox path.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and table-driven with no basic-concept padding, but the same rules are restated repeatedly: the 5000-char TTS cap appears in Expected inputs, Transitions, the failure table, and Guardrail 4; the 30-minute STT cap, profile-required rule, and SIGINT handling are each stated 2-4 times. This matches anchor 3 ("could be tightened") rather than 4, where over-explanation would be only minor. | 3 / 5 |
Actionability | Gives exact endpoints and commands ("GET http://127.0.0.1:17493/health", "claude mcp add --transport http voicebox http://127.0.0.1:17493/mcp"), concrete MCP tool signatures ("voicebox_speak { text, profile, language?, engine?, personality? }"), exit codes, output paths, and invocation examples. Falls short of anchor 5 because the processing mode's ffmpeg operations and a manifest field example are deferred to references rather than shown, leaving minor gaps. | 4 / 5 |
Workflow Clarity | Clear sequenced workflow (Entry steps, PREPARE→ACQUIRE→ACT→VERIFY→FINALIZE scenes) with explicit validation checkpoints ("VERIFY: Confirm the response carries audio output or transcript content. Validate manifest fields"), a clarification-protocol checklist, and feedback loops in the failure table ("MCP tool name drift → Re-run tools/list and update the cache"). Matches anchor 5's explicit validation with error-recovery loops. | 5 / 5 |
Progressive Disclosure | The References section is well-signaled and one level deep, with each resource annotated by purpose ("resources/voice-matrix.md (TTS profile/engine selection)", "resources/audio-processing.md", etc.), approaching anchor 5. Held at 4 because no bundle files are present to verify those references resolve, and some inline detail (the full MCP mapping notes and the Guardrail 8 manifest field specification) reads like reference material that could itself be split out. | 4 / 5 |
Total | 16 / 20 Passed |