Content
88%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-crafted prompt-driven skill body: concrete commands, a fully sequenced workflow with user-confirmation checkpoints, and clearly signaled one-level-deep references to seed templates. The only deductions are minor restatement in the file-selection rules and the fact that the five referenced template files could not be found in the reviewed bundle to verify.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and instruction-dense — the inline explainers are content the skill tells Claude to show the user, not concepts Claude is being taught, so they earn their place. Minor trimming is possible: the AGENTS.md/CLAUDE.md selection rules in step 4 are stated twice ("If neither exists, ask the user which one to create" followed by "Never create AGENTS.md when CLAUDE.md already exists (or vice versa) — always edit the one that's already there"), which is a small amount of restatement. | 4 / 5 |
Actionability | Fully concrete, executable guidance throughout: exact exploration commands ("`git remote -v` and `.git/config`"), exact paths to check, an enumerated decision menu with defaults for each section, precise file-selection rules, and a copy-paste-ready markdown block template. As an instruction-only skill its guidance is directly actionable with no pseudocode. | 5 / 5 |
Workflow Clarity | A clearly sequenced five-step process (Explore → Present findings one at a time → Confirm and edit → Write → Done) with explicit checkpoints: findings must be presented and approved per section, the user edits drafts before anything is written, and the write step guards against the risky cases (update the existing `## Agent skills` block in place, never create a duplicate file, never overwrite surrounding user edits). These confirmation and idempotency rules serve as the validation appropriate for config-file mutation. | 5 / 5 |
Progressive Disclosure | The body is well structured with a clear overview and well-signaled one-level-deep references to five seed templates, each listed with its purpose ("[issue-tracker-github.md](./issue-tracker-github.md) — GitHub issue tracker", etc.). However, none of the referenced template files were present in the reviewed skill folder, so the referenced bundle could not be verified — a minor organization/verification gap rather than a structural one. | 4 / 5 |
Total | 18 / 20 Passed |