Content
22%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.
The body is essentially a placeholder that restates the description and links to an external repo, with no concrete guidance, patterns, or workflow. It fails to add anything Claude does not already know from the frontmatter.
Suggestions
Replace the restated prose with concrete, executable guidance or code snippets that embody the constraints (e.g., example component patterns the skill enforces).
Add an explicit multi-step workflow for applying the constraints, including a validation/check step so output can be verified.
Move detailed material into signaled reference files under ./references/ and link them with clear 'See X.md' pointers instead of a single buried repo URL.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and does not over-explain known concepts, but it wastes tokens by restating the same description three times (Overview, When to Use, Instructions) instead of delivering lean, useful content. | 3 / 5 |
Actionability | It provides no concrete code, commands, or specific patterns — only 'This skill provides guidance and patterns for...', describing rather than instructing, which matches the entirely vague/abstract anchor. | 1 / 5 |
Workflow Clarity | There are no steps, sequence, or validation checkpoints; the only actionable element is an external repository link, matching the 'steps missing or incoherent' anchor. | 1 / 5 |
Progressive Disclosure | Sections exist and there is a single one-level external link, but the reference is a buried prose 'see the source repository' link rather than clearly signaled reference files, and no bundle files are provided to offload detail. | 3 / 5 |
Total | 8 / 20 Passed |