Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-organized, token-efficient instruction skill with concrete boundaries and a validation loop, but its primary weakness is that the main workflow and most referenced materials are delegated to files that do not exist in the bundle, and the provided scripts are not surfaced.
Suggestions
Add references/workflow.md (and the other referenced references/ files) or inline the staged install protocol so the core workflow is actually executable from the skill.
Reference the existing scripts/install-plugin-from-github.py and scripts/github_utils.py from the body so provided tooling is discoverable and aligned with the install flow.
Expand the Workflow section with an explicit sequenced checklist (fetch pinned ref -> quarantine -> validate -> install -> record provenance/rollback) rather than only pointing to an external file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and bullet-driven with no padding or explanation of concepts Claude already knows; every section (Inputs, Outputs, Constraints, Gotchas) earns its place and assumes competence. | 3 / 3 |
Actionability | Some concrete guidance exists (executable validation command, explicit network allowlist, concrete Inputs/Outputs), but the core install workflow delegates to 'references/workflow.md' which is not present, leaving key executable detail incomplete. | 2 / 3 |
Workflow Clarity | A validation checkpoint and fail-fast feedback loop are stated ('Fail fast: stop at first failed gate'), but the staged install sequence itself is not shown in the body — it is delegated to a missing reference — so the multi-step sequence is implicit rather than explicit. | 2 / 3 |
Progressive Disclosure | The 'Read when' navigation signals one-level-deep references clearly, but the actual bundle does not match: the references/ directory is absent (all four referenced files missing) while the existing scripts/ files are never referenced, so the disclosure promise is broken. | 2 / 3 |
Total | 9 / 12 Passed |