Content
77%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 router skill body: clear mode selection, explicit validation gates and feedback loops appropriate to batch page generation, and clean one-level-deep reference disclosure. Its main weakness is redundancy — the scope-exclusion list and guardrail framing are restated across several sections.
Suggestions
Consolidate the 'not for X / use Y' exclusion list into one place (e.g. the Scope paragraph) and reference it from the Instructions scope guard and Next Best Skill instead of restating it verbatim.
Dedupe the per-mode guardrail framing: state each guardrail once in the Mode Selector table and let the Instructions step reference it, rather than re-describing thin/duplicate, reputation-abuse, honesty, and NAP rules across Mode Selector, Skill Contract, and Instructions.
Inline at least one concrete snippet per mode (e.g. a minimal template×dataset row example or a NAP canonical-record shape) so the body is executable without opening every reference pack.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense with no basic-concept padding, but the 'not for X / use Y' scope list recurs verbatim in the scope paragraph, the Instructions scope guard, and Next Best Skill, and the guardrail framing is restated across Mode Selector, Skill Contract, and Instructions — noticeable redundancy that could be tightened. | 3 / 5 |
Actionability | Concrete routing inputs (mode selector table with required inputs and NEEDS_INPUT fallback), a real executable command ('python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/indexpush.py" indexnow --file new-urls.txt --key $INDEXNOW_KEY'), and specific save filenames; the core play execution is offloaded to reference packs rather than spelled out inline, a minor gap. | 4 / 5 |
Workflow Clarity | A clear 5-step sequence with explicit validation checkpoints and feedback loops for this batch/destructive skill: step 2 returns NEEDS_INPUT and stops on missing/inconsistent input, step 4 requires the guardrail verdict before handoff ('Flag any blocker; do not ship it silently'), and the index push is dry-run by default with '--live' gated behind the thin/duplicate guardrail passing. | 5 / 5 |
Progressive Disclosure | Well-organized overview (Quick Start, Mode Selector, Skill Contract, Data Sources, Instructions, Save Results, Reference Materials, Next Best Skill) with one-level-deep, clearly signaled links to the four real reference files, each annotated with its contents in the Reference Materials section. | 5 / 5 |
Total | 17 / 20 Passed |