Content
96%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.
An excellent instruction-only skill body: dense, imperative, fully executable commands with an explicitly validated preview→confirm→apply→verify workflow and strong safety guardrails. The only structural improvement would be splitting the per-harness procedures into clearly signaled reference files for better progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative throughout — no concept explanations Claude already knows, no padding, and every line carries instruction or a concrete command (e.g., "削除対象を推測しません。", "ウェルカム表示は成功後だけです。"). It matches the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready commands with explicit flags and JSON output: `claude plugin list --json`, `node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin --scope <scope> --hooks <hooks> [--move-scope] --dry-run --json`, npx fallbacks, and a complete `node -e` welcome-rendering invocation. Placeholders are explicit and clearly parameterized, covering the common cases per harness. | 5 / 5 |
Workflow Clarity | A clearly sequenced 5-step wizard (inventory → collect choices → preview/confirm once → apply → verify then welcome) with explicit validation checkpoints (exit code 0, setup result scope/hooks matching selections, exactly one enabled `ecc@ecc`) plus stop-on-error guidance and recovery paths — matching the explicit-validation and feedback-loop anchor. The destructive-operation cap does not apply since validation is present. | 5 / 5 |
Progressive Disclosure | Sections are well organized with clear per-harness navigation (## Claude Code / ## Codex / ## Kimi) and the body stays a reasonable size. However, at ~185 lines with all three harness procedures fully inlined and no bundle reference files, it sits between the 'good structure with minor gaps' anchor and the ideal split — per-harness procedures could live in one-level-deep reference files. | 4 / 5 |
Total | 19 / 20 Passed |