Content
70%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 a dense, well-sequenced operations document with genuinely executable commands, explicit success criteria, and strong failure/recovery loops. Its two real weaknesses are redundancy (routing and cost rules restated across three to four sections) and a progressive-disclosure layer whose referenced resource files are entirely absent from the bundle, leaving the deferred detail unreachable.
Suggestions
State each routing fact once: consolidate the existing-media/ffmpeg-skill and earshot/sound-design loading rules (currently repeated in 'When to use', 'Dependencies', 'Structural Flow', and 'Canonical command path') into the single 'Conditional resources' section.
Ship the referenced resource files (resources/execution-protocol.md, resources/existing-media.md, resources/sound-design.md, resources/script-schema.md, resources/checklist.md, etc.) in the bundle, or inline the critical detail — currently every deferred reference is a dangling path.
Add at least one concrete example command for the existing-media and sound-design branches (e.g., the upstream ffmpeg-skill invocation or an earshot cue-placement call) so both major branches are actionable without leaving SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and never explains known concepts, but the same routing facts are repeated: existing-media/ffmpeg-skill loading appears in four places ("When to use", "Dependencies", "Structural Flow", "Canonical command path") and earshot/sound-design routing in three, plus cost/consent rules restated across sections. This is more than the "minor instances" of the 4 anchor, so it sits at mostly-efficient-but-could-be-tightened. | 3 / 5 |
Actionability | The command block is copy-paste ready ("oma video generate \"Jeju coffee\" --mode shorts --aspect 9:16 --captions tiktok --script ./script.json", "oma video compose <runDir>", "oma video doctor") and the JSON return shape is enumerated. It falls short of fully-executable because the existing-media and sound-design branches — half the skill's scope — defer all executable detail to resource files with only abstract direction like "follow its supported operation". | 4 / 5 |
Workflow Clarity | The canonical command path is numbered and ordered, with explicit validation checkpoints ("The command lints, renders, and ffprobes the output", "a real MP4 passes video-stream and duration validation", "manifest hashes validate"), a feedback loop ("Fix a reported composition or toolchain failure and re-run; return a failure report when it cannot render"), a cost gate before paid actions, and a pre-handoff checklist reference. This matches the anchor for clear sequence, explicit validation, and error-recovery loops. | 5 / 5 |
Progressive Disclosure | In-document structure is good — a dedicated "Conditional resources" section with one-level-deep, clearly signaled references ("Load only what the task needs") — but scoring against the actual bundle, none of the ~10 referenced files (resources/execution-protocol.md, resources/existing-media.md, resources/script-schema.md, resources/checklist.md, etc.) exist in the bundle. The disclosure structure is an unfulfilled promise, so navigation is better organized than a 2 but clearly broken versus a 4. | 3 / 5 |
Total | 15 / 20 Passed |