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 well-structured, token-efficient instruction skill: mode detection is decision-test driven, each branch has a clear sequence, and hard blocking gates with failure handling are explicit. The only weakness is that a few steps defer to artifacts (workflows, bootstrap rules) without saying where they are found.
Suggestions
Tell the reader where 'the most matching workflow' and 'bootstrap rules' are located (path or source), since the skill currently instructs loading content it never points to.
Specify what 'search/discover the tool if needed' means concretely (e.g., which command or directory to search) so the MCP-mode steps are fully executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and efficient with zero padding: every line carries non-obvious operational detail (mode detection markers, tool names, file paths, blocking-gate rules) and assumes Claude's competence throughout. | 5 / 5 |
Actionability | Concrete detection tests ("If `RUNNING AS A PLUGIN` is in context", "`get_context_instructions` tool is available") and specific file paths ("Read `docs/CONTEXT.md` and `docs/ARCHITECTURE.md` in full") make most guidance executable, but steps like "Identify and load the most matching workflow" and "search/discover the tool if needed" give no pointer to where workflows or the tool live — minor gaps. | 4 / 5 |
Workflow Clarity | Three mode branches are clearly sequenced with explicit checkpoints: "blocking gate — do not proceed until complete", "DO NOT proceed to any action until all prep steps are confirmed complete", and a failure-recovery loop ("If anything fails or is unclear — stop and ask user"). Validation and error handling are explicit. | 5 / 5 |
Progressive Disclosure | Well-organized single-file structure with clear mode sections and no nested references (a sub-50-line skill with no external files needs little else), but "the loaded bootstrap rules" and "the most matching workflow" point to content with no signal about where it resides — a minor navigation gap. | 4 / 5 |
Total | 18 / 20 Passed |