Content
63%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.
Highly actionable content with concrete Cursor-specific paths, field documentation, and copy-paste-ready templates, undermined by significant verbosity and a monolithic structure. Roughly a third of the body is duplicate templates or generic example prompts that belong in separate reference files.
Suggestions
Move the six 'Common Subagent Patterns' and two 'Complete Examples' into a references/examples.md file and keep only one or two short representative examples inline, cutting the body by roughly half.
Collapse the three near-identical template blocks (File Format, Recommended structure, Quick Template) into a single template, and merge the 'DO/AVOID' list with the 'Anti-Patterns to Avoid' section that repeats it verbatim.
Embed per-step validation in the creation workflow (e.g., after configuring frontmatter, verify required fields and kebab-case naming before proceeding) instead of only a final checklist.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~726-line body contains three near-identical template blocks (File Format, Recommended structure, Quick Template), a DO/AVOID list that repeats the Anti-Patterns section verbatim, and roughly 350 lines of full example subagent prompts that largely restate generic knowledge. Several padded sections push it below the 'mostly efficient' anchor. | 2 / 5 |
Actionability | Fully executable guidance: exact file paths (.cursor/agents/agent-name.md), a complete frontmatter field table with defaults, copy-paste-ready example subagent files, a quality checklist, and a concrete output-message template covering the common cases. | 5 / 5 |
Workflow Clarity | The creation process is a clear 5-step sequence (Define Purpose, Choose Location, Configure Frontmatter, Write Prompt, Be Focused) with a Quality Checklist and a test-the-description verification step. Not 5 because validation checkpoints appear only at the end rather than embedded as feedback loops between steps. | 4 / 5 |
Progressive Disclosure | Sections are well-organized, but no references/ files exist and ~350 lines of pattern and example content (6 common patterns plus 2 complete examples) that clearly belongs in separate reference files are inlined in a single monolithic 726-line SKILL.md. | 3 / 5 |
Total | 14 / 20 Passed |