Content
71%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 body is a well-organized reference index with executable quick-reference material and a useful version-comparison table, but its central progressive-disclosure design depends on ~24 referenced rule/example/template files that are absent from the bundle, breaking navigation. Tightening the redundant pitfall/command sections would further improve token efficiency.
Suggestions
Ship the referenced bundle files (rules/*.md, examples/*.py, templates/*.py) or remove the dead links, since progressive disclosure depends on those targets actually existing.
De-duplicate the version-confusion guidance: the 'Key Differences' table already covers it, so trim 'Common Pitfalls' items 1-2 to avoid repetition.
Consolidate the render-flag examples ('Render Command' and 'Useful Commands') into a single CLI quick-reference block to reduce redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Category-based file listings with one-line descriptions and tight code snippets keep it efficient, but 'Common Pitfalls' repeats version-confusion points already in the comparison table and 'Useful Commands' re-lists render flags shown earlier. | 4 / 5 |
Actionability | Inline content is concrete and executable (a complete Scene example, real render commands, the %%manim cell magic, install/checkhealth commands), though most actionable depth is delegated to rule files rather than shown here. | 4 / 5 |
Workflow Clarity | As a single-purpose reference/lookup skill it qualifies for the simple-skill exception; the 'How to use' index and Quick Reference give clear entry points, with only minor gaps in guidance on selecting the right rule file for a task. | 4 / 5 |
Progressive Disclosure | The body is well-structured with clearly signaled one-level-deep references organized by category, but the referenced bundle directories (rules/, examples/, templates/) do not exist, so the navigation links do not resolve and the drill-down promise is broken. | 3 / 5 |
Total | 15 / 20 Passed |