Content
56%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 well-structured with a clear six-step workflow and a genuinely useful error-handling table, and it correctly pushes detail to one-level-deep references. Its weaknesses are duplicated example content between the body and references, search commands deferred out of the body without inline equivalents, and several bundle files (examples.md, scripts/, assets/) that are completely unreferenced from SKILL.md.
Suggestions
Link the scripts/ and assets/ files from the body (e.g. a Resources entry for scripts/plugin_analyzer.py and assets/plugin_selection_rules.yaml) so the bundle is discoverable, and delete or flesh out the vacuous references/examples.md stub.
De-duplicate the Examples section against references/example-workflows.md — keep one-line scenario pointers in the body and move the detailed processes to the reference; consider moving the Error Handling table into errors.md, which is currently a thinner version of it.
Inline the actual discovery commands (e.g. `grep -r "keyword" --include="plugin.json" plugins/`) from how-it-works.md into Step 2 so the core workflow is executable from the body alone.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient — no tutorials on concepts Claude already knows, and the Prerequisites section is usefully specific — but it carries real duplication: the Overview restates the frontmatter description, and the Examples section repeats content that also lives in references/example-workflows.md (the code-analysis example appears nearly verbatim in both). Anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') fits; it is not 4 because the duplicated example block is more than a minor trim. | 3 / 5 |
Actionability | The instructions give concrete targets (directory globs, 'commands/*.md', 'agents/*.md', 'skills/*/SKILL.md', matching on plugin.json descriptions) and a structured output spec, but the search step itself contains no executable command in the body — the actual grep/find commands are deferred to references/how-it-works.md — and synthesis/application steps ('merging complementary approaches, simplifying where possible') stay abstract. This lands on anchor 3 ('some concrete guidance but incomplete; missing key details') rather than 4, which expects concrete commands with only minor gaps. | 3 / 5 |
Workflow Clarity | The six-step Instructions form a clear, ordered sequence (analyze task → search → extract → synthesize → apply → report), and the Error Handling table gives explicit recovery paths for the likely failure modes (no matches → broaden/fall back; incompatible patterns → prioritize most relevant; empty files → skip and note). It is not 5 because there is no mid-workflow checkpoint (e.g. verify extracted patterns against the task requirements before applying) — the fallback guidance is reactive rather than a validate-and-retry loop. | 4 / 5 |
Progressive Disclosure | References are one level deep and clearly signaled (inline links plus a Resources section), but organization has notable gaps: the Error Handling table lives in the body while references/errors.md is a thinner generic stub; the code-analysis example is duplicated between body and references/example-workflows.md; references/examples.md is an unreferenced vacuous stub; and the scripts/ and assets/ bundles (plugin_analyzer.py, skill_adaptation_template.py, plugin_selection_rules.yaml) are never linked from SKILL.md at all, with references/README.md even naming a different skill ('pi-pathfinder'). This sits between anchors 3 and 4 — signaling is better than 3 but the placement, duplication, and orphaned bundle files exceed 'minor organization gaps'. | 3 / 5 |
Total | 13 / 20 Passed |