Content
76%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 router SKILL.md that is highly actionable — every sub-domain has verified, executable commands — with lean, table-based prose. The main weaknesses are missing validation/feedback loops for batch generation workflows (CIP full set, icon batches) and some duplication between inline quick-reference tables and the reference files.
Suggestions
Add explicit validation steps after batch generation, e.g. verify each CIP --set deliverable image exists and is non-trivial, and re-run failed generations individually before presenting results.
Deduplicate: drop the inline Banner Quick Size Reference / Top Art Styles tables in favor of the reference file, and merge the Slides knowledge-base table into the single References table.
Unify the Slides entry point — routing table cites references/slides.md while the workflow uses references/slides-create.md; pick one canonical pointer.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is command- and table-dense with almost no explanation of concepts Claude already knows; script paths resolve correctly and MuAPI model details defer to external URLs. Minor over-verbosity remains: the banner size/style tables are duplicated between SKILL.md and references/banner-sizes-and-styles.md, and the five slides files are listed twice (Slides knowledge-base table plus the References table). | 4 / 5 |
Actionability | Nearly every section gives copy-paste-ready bash commands with concrete flags and realistic arguments (e.g. `python3 scripts/logo/generate.py --brand "TechFlow" --style minimalist --industry tech`), and all referenced script paths (scripts/logo/search.py, scripts/cip/generate.py, scripts/icon/generate.py, scripts/cip/render-html.py, etc.) exist in the bundle. Example invocations cover the common cases per sub-domain. | 5 / 5 |
Workflow Clarity | Sequenced workflows exist for banners and social photos, and the social-photos workflow includes an explicit verify-and-fix loop, but batch operations lack validation: `scripts/cip/generate.py --set` produces the full 50+ deliverable set and `scripts/icon/generate.py --batch 4` generates multiple icons with no step to check outputs or re-run on failure (logo guidance is only the vague 'When scripts fail, try to fix them directly'). Per the rubric's batch-operation rule, missing feedback loops there caps this at 3 rather than 4. | 3 / 5 |
Progressive Disclosure | Good router-style structure: a sub-skill routing table, per-domain quick-reference sections, and References/Scripts tables whose entries all correspond to real files in references/ and scripts/, with details one level deep. Minor gaps: the banner quick-reference tables duplicate content in the referenced file, the slides knowledge-base table duplicates rows in the References table, and the routing table points Slides at references/slides.md while the body workflow uses references/slides-create.md — two files for the same entry point. | 4 / 5 |
Total | 16 / 20 Passed |