Content
75%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, instruction-only meta-skill with a clear numbered workflow, concrete tool guidance, and explicit verification in the placement step. Main weakness is mild redundancy between the opening paragraph, 'When to use', and the description, plus a missing full worked output example.
Suggestions
Trim the redundancy between the opening paragraph and the 'When to use' list, since both restate the source types and invocations already in the frontmatter description.
Add one small complete example of a resulting SKILL.md (frontmatter plus a few body lines) so the authoring step has a copy-paste-ready reference rather than only a frontmatter template.
Make the step-5 validation unconditional — e.g. always confirm the folder name matches the frontmatter and the YAML parses — rather than gating the dry-run on 'if feasible'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean procedural guidance that assumes Claude's competence and avoids explaining basic concepts, but the opening paragraph and 'When to use' section repeat trigger/source information already in the description, which could be trimmed. Not a 5 because of this noticeable redundancy; not a 3 because the bulk is efficient and non-padded. | 4 / 5 |
Actionability | Gives concrete, executable guidance — naming specific tools ('Glob the structure, Read the key files, Grep', 'WebFetch the page'), a YAML frontmatter template, and a worked Example — so Claude knows exactly what to do. Not a 5 because there is no complete finished SKILL.md example to copy, only the frontmatter template; not a 3 because the steps are specific and actionable rather than pseudocode. | 4 / 5 |
Workflow Clarity | A clearly numbered five-step workflow (Identify → Gather → Distill → Author → Place and verify) with explicit verification in step 5 ('confirm the folder name matches... and the YAML parses', 'dry-run the procedure... to confirm it is correct') and a defined refine branch. Not a 5 because the dry-run validation is conditional ('If feasible') and checkpoints are otherwise implicit; not a 3 because validation steps are present. | 4 / 5 |
Progressive Disclosure | Well-organized single-file skill with clear sections (When to use, Workflow, Example, Notes) and an inlined, one-level reference to docs/skill-guidelines.md rather than nested deferrals; no bundle files are needed. Not a 5 because the skill exceeds the under-50-line simple-skill exception and the docs/skill-guidelines.md pointer is informational rather than a clearly signaled navigation aid. | 4 / 5 |
Total | 16 / 20 Passed |