Content
82%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-structured, highly actionable skill body with copy-paste commands, a clear phased workflow, and appropriate offloading of detail to reference files. Main improvements are adding an explicit failure/validation checkpoint and deduplicating the transcript-backend ordering.
Suggestions
Add an explicit validation/error-recovery step in Phase 1 (e.g., 'if the script exits non-zero or transcript_method is empty, fall back to the next backend per the preferred order') to raise workflow clarity.
De-duplicate the transcript backend preference list between the body's 'Minutes-first transcription rules' and dependencies.md by keeping the canonical ordered list in dependencies.md and briefly referencing it from the body.
Link output-schema.md from the 'Output contract' section (where its fields are most useful) in addition to the Dependencies section, so the reference is discoverable at the point of need.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and assumes Claude's competence, but the 'Minutes-first transcription rules' preferred-order list duplicates content also in dependencies.md, and a few sections could be tightened. | 4 / 5 |
Actionability | Fully executable copy-paste-ready bash commands with real plugin-root paths and a useful-options block covering common cases (focus, cookies, env-file, frame-step, max-frames, keep-temp). | 5 / 5 |
Workflow Clarity | Clear three-phase sequence (run pipeline, inspect artifacts, produce brief) with named outputs, but lacks an explicit validation/error-recovery checkpoint if the script or transcription fails. | 4 / 5 |
Progressive Disclosure | Good structure with one-level-deep references to real files (dependencies.md, output-schema.md) signaled via plugin-root paths, though output-schema.md is linked only under Dependencies rather than near the Output contract where it is most relevant. | 4 / 5 |
Total | 17 / 20 Passed |