Content
67%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 delivers concrete, executable setup and usage guidance with unusually strong safety gating (pinned revision, review-before-install, approval checkpoint, scope verification). Its main weaknesses are redundant purpose statements and the absence of error-recovery steps.
Suggestions
State the skill's purpose once — remove the verbatim description echo in "When to Use" and the filler "Example" user request, which adds no new guidance.
Add a short error-recovery step to Setup (e.g., what to check if `npm ci` or `npm run compile` fails, or how to confirm the MCP server actually started).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill's purpose is stated three times — the description is echoed verbatim in "When to Use", paraphrased again in the next paragraph, and restated in the "Example" user request — and the Limitations section is partly boilerplate. The remaining sections are otherwise tight. | 3 / 5 |
Actionability | Concrete, executable commands throughout: a pinned-revision clone, `npm ci`, `npm run compile`, `npm run start-server my-project "$(pwd)"`, and MCP tool calls with args and usage examples. Minor placeholders (`cd <approved-agent-memory-directory>`, `content: "..."`) keep it from being fully copy-paste ready. | 4 / 5 |
Workflow Clarity | The review → install → start sequence is clear with explicit checkpoints ("wait for explicit user approval", "verify the resulting file changes", "check the resulting documentation diff"), but there are no error-recovery loops for failures such as a compile error or server startup failure. | 4 / 5 |
Progressive Disclosure | A single, well-sectioned SKILL.md with no bundle files and clear navigation, but at ~110 lines it exceeds the under-50-line simple-skill exception, and content like the security review checklist and MCP tool reference could be split into separate files. | 4 / 5 |
Total | 15 / 20 Passed |