Content
56%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 content is a thorough, actionable specification for a complex multi-mode video router with a clear sequenced workflow and validation. Its main weakness is progressive disclosure: it relies heavily on a resources/ bundle that is not present, leaving the navigation structure non-functional.
Suggestions
Ship the referenced resources/ bundle (execution-protocol.md, vendor-matrix.md, prompt-tips.md, checklist.md, remotion-authoring/, strudel/, mpt/) alongside SKILL.md so the in-body references resolve to real files.
Tighten the music/BGM section (presets, LUFS rationale, normalization-vs-loudnorm aside) into a brief pointer to a resources file, since this detail competes with core routing context.
Make the VERIFY stage validation a scripted, copy-paste command (e.g. an explicit manifest/schema check invocation) rather than a described checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and largely efficient for a complex multi-mode router, but sections like the music BGM presets, LUFS normalization rationale, and repeated clarification guidance include over-explanation that could be trimmed. | 3 / 5 |
Actionability | Concrete, runnable CLI invocations and flag references dominate the Invocation and Canonical command path sections, with only minor gaps (e.g. some Remotion authoring details deferred to resources). | 4 / 5 |
Workflow Clarity | A clear PREPARE/ACQUIRE/ACT/VERIFY/FINALIZE sequence with explicit validation (VERIFY validates asset-bus schemas, manifest hashes, exit code, mp4) and recovery branches is present; only some validation checkpoints are implicit rather than scripted. | 4 / 5 |
Progressive Disclosure | The body references many resources/ paths (execution-protocol.md, vendor-matrix.md, prompt-tips.md, checklist.md, remotion-authoring/, strudel/render.mjs, mpt/driver.py) but the referenced bundle directories (references/, scripts/, assets/, resources/) do not exist alongside SKILL.md, so the navigation points to files that are absent and cannot be navigated as structured. | 1 / 5 |
Total | 12 / 20 Passed |