Content
92%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-engineered skill body: lean routing-driven structure, verified executable commands, an explicit validate-before-and-after loop with confirmation gates for batch operations, and a complete one-level-deep reference bundle. The only weaknesses are mild redundancy between the routing table, workflow, and quick-commands sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and functional — a routing table, terse operating rules, and a short commands block — with no explanations of concepts Claude already knows. Not 5 because there is mild redundancy: script paths appear in both the routing table and 'Quick commands', and 'Do not use this skill for' partially restates scope already delimited elsewhere. | 4 / 5 |
Actionability | The 'Quick commands' block gives copy-paste-ready invocations whose flags (`--input <path> --json`, `--skill-dir <path>`, `--source-dir skills --skill <name> --agent cursor --scope project --mode symlink`) match the actual argument parsing in the bundled scripts, and the routing table maps every task to a concrete reference file and script. Not 4 because the commands are executable as written and cover the common install/validate/inspect cases. | 5 / 5 |
Workflow Clarity | The six-step workflow is clearly sequenced with an explicit validation checkpoint ('Use `scripts/validate-skill.mjs` before and after installation'), confirmation gates for risky batch operations ('summarize the planned batch operation before execution and wait for confirmation'), and a 'Minimum self-check' checklist for error recovery. This satisfies the feedback-loop expectation for batch/destructive operations, so the workflow-clarity cap does not apply. | 5 / 5 |
Progressive Disclosure | SKILL.md is a clear overview: every referenced path (`references/source-classification.md`, `migration-playbook.md`, `cli-alignment.md`, `install-workflow.md`, `mapping-extension.md`, and the three scripts) exists in the bundle, references are exactly one level deep with no nested pointers, and the routing table plus workflow steps signal exactly when to open each file. Not 4 because navigation is explicit and the split between overview and detail is clean. | 5 / 5 |
Total | 19 / 20 Passed |