Content
100%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.
An exemplary SKILL.md body: dense, actionable command-first guidance with a clearly sequenced locate→generate→check→verify workflow, explicit validation and repair loops, and disciplined one-level-deep references into a large bundle. No dimension shows a real weakness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and purely imperative ("Resolve the directory containing this file as SKILL_ROOT", "Keep one semantic connector per business edge") with no explanation of concepts Claude already knows. Not 4: there is no over-explanation to trim; the repeated SKILL_ROOT export block is a runnable pattern, not padding. | 5 / 5 |
Actionability | Gives copy-paste-ready commands for the full pipeline — "fireworks.py validate architecture input.json", "render … --report layout.json", "check", "export-png … --width 1920", "export-html", "animate" — covering the common cases, with the one placeholder explicitly explained. Not 4: commands are complete and executable as written. | 5 / 5 |
Workflow Clarity | Clear sequence (locate/select → generate and check → additional outputs → verify) with explicit validation gates ("Resolve that warning before claiming complete exact text", "If viewing is unavailable, explicitly mark the visual check skipped") and a concrete failure feedback loop: "After a failed check, use its element IDs and geometry to make a focused repair; change the approach after two unchanged failures." | 5 / 5 |
Progressive Disclosure | Seven well-signaled markdown links (style matrix, layout reference, icons, composition contract, visual quality, PNG export, motion effects) each verified to exist in references/, all one level deep, with conditional-loading guidance ("Read other styles only for a requested comparison"). The 20+ bundle files stay out of the overview while remaining discoverable. | 5 / 5 |
Total | 20 / 20 Passed |