Content
57%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 SKILL.md is a well-organized navigation hub with a strong executable quick-start, but it suffers from a major bundle-integrity problem: most referenced documentation, rule, and example files are absent. This breaks progressive disclosure and the validation checkpoints the workflows rely on.
Suggestions
Restore or remove the missing bundle directories (docs/, rules/, examples/, tools/, prompts/, data/) so every referenced path resolves — currently ~17 of the linked files do not exist.
Inline the 'Quick Edit Runtime Template' and 'Acceptance Checklist' or ensure docs/agent-playbook.md exists, so batch/export workflows have explicit validation checkpoints rather than dead references.
De-duplicate the rules listing (the Rules section and Agent Quick Routing repeat the same rules/*.md links) to tighten token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a mostly efficient routing hub with executable code, but rules are listed twice (Rules section and Agent Quick Routing) and bilingual headings add redundancy that could be tightened. | 3 / 5 |
Actionability | The inline quick-start is copy-paste ready (env detection, JyProject, add_narrated_subtitles, add_media_safe, save) and CLI commands point to real scripts; minor gaps come from example/rule files that are referenced but absent. | 4 / 5 |
Workflow Clarity | A numbered quick-start sequence exists, but the 'Acceptance Checklist' and 'Quick Edit Runtime Template' are deferred to a non-existent docs/agent-playbook.md, and batch/export workflows lack inline validation checkpoints — capping this at 3. | 3 / 5 |
Progressive Disclosure | References are clearly signaled and grouped by category (good structure), but scored against the actual bundle a large portion of referenced paths (docs/, rules/, examples/, tools/, prompts/, data/) do not exist, leaving many dead links. | 3 / 5 |
Total | 13 / 20 Passed |