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.
The body is a tightly-written, highly actionable workflow with explicit validation checkpoints, concrete commands, and well-signaled external spec references. The only room for improvement is mild tightening of the auth/jq guardrail paragraphs and optionally extracting spec detail into a bundled reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence — no padding about what a plugin or manifest is — with every section earning its place; only minor stretches (the long plugin.repo and jq guardrail paragraphs) could be trimmed. Not 5 because the auth/repo handling paragraph and jq-availability note run long; not 3 because there is no wasted conceptual explanation. | 4 / 5 |
Actionability | Provides copy-paste-ready, fully executable commands throughout — `od plugin validate`, `od plugin pack`, `od plugin install --source <absolute-folder-path>`, `gh --version`, `gh auth status`, `node -e '...'` — plus specific recovery commands and an explicit list of forbidden placeholder owners. Covers the common cases concretely; not 4 because guidance is complete rather than having minor gaps. | 5 / 5 |
Workflow Clarity | A clear sequenced workflow — read project files in order → derive → scaffold generated-plugin/ → validate → pack → install → single summary → STOP — with an explicit validation checkpoint (`od plugin validate`) and error-recovery guidance for auth problems. The validation step is present so the destructive/batch cap does not apply; not 4 because checkpoints and feedback loops are explicit rather than minor-gapped. | 5 / 5 |
Progressive Disclosure | The ~70-line body is well-organized into clearly-headed sections (Required outcome, Auto-derive, Validate, When done, Do NOT chain, Language, folder shape, Spec references) with one-level-deep pointers to `docs/plugins-spec.md`, the plugin schema, and the sibling authoring SKILL.md. No bundle files exist, so this is judged on body structure; not 5 because there are no separate reference files to split the spec detail into, and not 3 because structure and signaling are already good. | 4 / 5 |
Total | 18 / 20 Passed |