Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a lean, well-scoped meta-skill that clearly communicates its core principles without verbosity. Its main weakness is the lack of concrete examples (good vs bad SKILL.md snippets) and the absence of a lightweight workflow or checklist for applying these principles when authoring or revising a skill file.
Suggestions
Add a brief before/after example showing a bad SKILL.md snippet (with hardcoded tool/param names) vs a good one (using prose descriptions), to make the principles immediately actionable.
Include a short checklist or workflow (e.g., 'Draft → verify no tool names → verify no param names → confirm MCP fetch instruction') to give authors a concrete review process.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every sentence carries unique, non-obvious information. No padding, no explanation of concepts Claude already knows. The prose-over-code-names rationale is genuinely novel guidance that wouldn't be inferred. | 3 / 3 |
Actionability | The skill provides clear principles (don't duplicate, don't name tools/params, fetch from MCP at call time), but it lacks concrete examples of a well-written vs poorly-written SKILL.md snippet. The guidance is specific enough to follow but would benefit from a before/after example. | 2 / 3 |
Workflow Clarity | The skill is a set of principles rather than a multi-step workflow, but for a skill about authoring/revising SKILL.md files, a brief sequence (e.g., 1. Draft skill, 2. Check against these principles, 3. Verify no tool/param names leaked) would improve clarity. The current bullet-list format is clear but lacks any validation or review checkpoint. | 2 / 3 |
Progressive Disclosure | For a simple, short skill under 50 lines with no need for external references, the content is well-organized into a concise set of principles. No monolithic walls of text or unnecessary nesting. | 3 / 3 |
Total | 10 / 12 Passed |