Content
57%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 well-structured and reasonably concise, with a clear use/anti-use framing and output format. Its main weaknesses are generic, non-concrete instructions and a referenced resource file that is not bundled, which weakens both actionability and progressive disclosure.
Suggestions
Provide the missing `resources/implementation-playbook.md` or inline a few concrete refactor patterns/examples so guidance is actionable without a broken reference.
Replace vague instruction bullets with specific techniques (e.g., named refactoring patterns, how to detect duplication, concrete test commands).
Add an explicit validation feedback loop (validate -> if failing, fix and re-validate -> only proceed when green) to lift workflow clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with clear sections, but repeats the frontmatter description verbatim at the top and the 'Context' section re-states the skill's purpose, which are minor over-explanations that could be trimmed. | 4 / 5 |
Actionability | Instructions are high-level directives ('Identify high-impact refactor candidates', 'Break work into small, testable steps') rather than concrete techniques, and the detailed patterns are deferred to `resources/implementation-playbook.md`, a file that is not present in the bundle. | 3 / 5 |
Workflow Clarity | A sequence is present (identify -> break into steps -> apply -> validate) and a validation step is mentioned, but there is no explicit feedback loop (validate -> fix -> re-validate) and checkpoints remain implicit. | 3 / 5 |
Progressive Disclosure | Sections are well organized and the reference to `resources/implementation-playbook.md` is clearly signaled, but that referenced file does not exist in the bundle, so the disclosure structure promises deeper content that is missing. | 3 / 5 |
Total | 13 / 20 Passed |