Content
30%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is well-organized and appropriately short for a self-contained skill, but it is almost entirely generic guidance with no concrete, executable instructions or a real workflow. It reads as a template placeholder rather than operational guidance.
Suggestions
Replace abstract capability bullets with concrete, actionable instructions (specific commands, tools, or step-by-step procedures) so Claude knows exactly what to do.
Provide a real sequenced workflow with validation checkpoints for the long-running tasks the skill claims to handle, rather than behavioral platitudes.
Remove the duplicate spurious YAML frontmatter block in the body (the second 'name/description/category' block) and the filler closing line to tighten token usage.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is brief and does not explain concepts Claude already knows, but it is padded with generic platitudes ("Take Your Time: Don't rush - quality over speed", "Remember: You have plenty of time to do thorough, high-quality work!") that could be tightened; it is not a 1 because it avoids concept re-explanation, and not a 3 because the filler does not earn its place. | 2 / 3 |
Actionability | There is no executable code, no commands, and no concrete examples; items like "Complex Analysis: Deep dive into codebases" and "Document Everything" describe rather than instruct, matching the score-1 anchor. The instruction-only guidance is not actionable, so the absence-of-code exemption does not apply. | 1 / 3 |
Workflow Clarity | The numbered "Instructions" list (Take Your Time, Be Thorough, Communicate Progress) is a set of behavioral attitudes, not a sequenced multi-step workflow, and there are no validation checkpoints for the long-running tasks it claims to handle; it does not reach a 2 because there is no real task sequence. | 1 / 3 |
Progressive Disclosure | The skill is under 50 lines, self-contained with no external bundle files, and organized into clearly headed sections (Capabilities, Instructions, Output Format, Example Use Cases) with no nested references, satisfying the simple-skill allowance for a score of 3. | 3 / 3 |
Total | 7 / 12 Passed |