Content
71%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.
A well-structured, lean skill body with strong progressive disclosure and a clear verification-gated workflow. Its main weaknesses are incomplete actionability — the installer command is never named despite scripts existing — and a missing error-recovery feedback loop for a destructive operation.
Suggestions
Name the concrete installer command in the workflow (e.g. `python scripts/install-skill-from-github.py ...` / `python scripts/list-skills.py`) instead of the abstract "Run minimal installer helper command", and link the scripts so the guidance is copy-paste executable.
Add an explicit validate→fix→retry feedback loop after the filesystem verification step, since the skill performs overwrite-capable installs.
Deduplicate the Anti-Patterns and Constraints sections (overwrite-without-confirmation and untrusted-URL handling each appear twice) to recover the conciseness that the duplication costs.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no padding or over-explanation of known concepts, but the Anti-Patterns and Constraints sections duplicate each other ("Do not overwrite existing installs without explicit confirmation" / "Treating untrusted URLs or paths as safe inputs"), which is minor trimming that could be done; not a 5 because of that redundancy. | 4 / 5 |
Actionability | The workflow step "Run minimal installer helper command" never names the actual script or invocation, and the available scripts (install-skill-from-github.py, list-skills.py) are not referenced from the body, so executable guidance is incomplete despite the concrete output-contract fields; not a 4 because the key command detail is missing. | 3 / 5 |
Workflow Clarity | A clear 5-step sequence with an explicit verify-filesystem checkpoint (step 4) and a required validation_evidence field, but it lacks an explicit validate→fix→retry feedback loop for a destructive/overwrite-capable operation; not a 5 because error-recovery feedback is absent. | 4 / 5 |
Progressive Disclosure | The body is an overview with three well-signaled one-level-deep references (install-flows.md, troubleshooting.md, contract.yaml), each gated by an explicit "Read when" condition and verified to exist in references/, making navigation easy with no nesting. | 5 / 5 |
Total | 16 / 20 Passed |