Content
85%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-architected instruction skill: a tight overview with one-level-deep references that all resolve, a gated 6-step workflow with blocking validation and retry feedback loops, and consistently actionable guidance with exact paths and flags. The only slack is mild verbosity in the backend-resolution branches and reliance on references for full prompt templates.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and mostly actionable with exact paths, flags, and naming conventions, and the ⛔ guardrails earn their tokens; it is efficient with only minor over-explanation. It is not a 5 because the multi-branch backend-resolution list and some repeated caveats could be trimmed, and not a 3 because the content is largely necessary domain-specific policy rather than padding. | 4 / 5 |
Actionability | Concrete, executable guidance pervades the body — exact file naming (NN-{type}-{slug}.md), flag syntax (--type/--style/--palette/--preset), path tables, and a numbered 6-step workflow. It is not a 5 because the actual prompt templates and detailed sub-procedures are delegated to references rather than inlined, leaving minor gaps in self-contained executability; not a 3 because what is written is specific and actionable, not pseudocode. | 4 / 5 |
Workflow Clarity | The 6-step workflow is a checklist with explicit blocking validation gates ("⛔ BLOCKING", "Hard gate", prompt-files-must-exist-before-generation), confirmation policy, and feedback loops (retry once on failure, regenerate-from-corrected-prompt for text fixes). This matches the 5 anchor (clear sequence + explicit validation + feedback loops + checklists), and the batch/destructive operation correctly includes validation. | 5 / 5 |
Progressive Disclosure | SKILL.md is a clear overview that signals one-level-deep references via markdown links and a References table (workflow.md, styles.md, style-presets.md, prompt-construction.md, codex-imagegen.md, config/*), and all referenced paths exist as real bundle files. Content is appropriately split (procedures, styles/, palettes/), giving easy navigation matching the 5 anchor. | 5 / 5 |
Total | 18 / 20 Passed |