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.
A strong, highly actionable skill body: an 8-phase workflow with explicit STOP/blocked gates, user-confirmation checkpoints, and a validate-fix-retry verification loop, plus concrete tool commands and a PR checklist. Weaknesses are minor: duplicated safety rules between the Instructions and Troubleshooting sections, and references that escape the skill's own directory into an unverifiable shared path.
Suggestions
State each blocked/caution rule once: the empty-critical-set STOP, dynamic keys, WithConfig config-mismatch, and no-call-sites rules appear in full in both the Instructions phases and the Troubleshooting table — keep the Troubleshooting row as a one-line pointer to the phase or readiness.md anchor instead of restating the rule.
Make the shared-tree references verifiable from the skill bundle: tool-map.md, sdk-patterns.md, write-safety.md, and scope-establishment.md are reached via `../../../` paths outside the skill's own directory and did not resolve here — either vendor them under references/ or confirm the relative paths resolve where the skill is installed.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and prescriptive — no padding, no explanations of concepts Claude already knows, and heavy use of compact tables for tool mappings and troubleshooting. Not 5 because several safety rules are stated twice: the empty-critical-set STOP, dynamic-key blocked, WithConfig config-mismatch, and no-call-sites rules each appear in full in both the Instructions phases and the Troubleshooting table, and Phase 3 restates rules also carried in readiness.md. Not 3 because the duplication is deliberate emphasis on a handful of short rules rather than 'some unnecessary explanation' spread throughout. | 4 / 5 |
Actionability | The tool table gives copy-paste-ready CLI commands (e.g., `harness get feature_flag <flag> --json`) and exact MCP invocations with params and filters, and the phases specify executable mechanics (advance `filters.offset` until a short page, record `file:line` per hit, work on a new branch, re-run the search after edits). As an instruction-only skill the guidance is concrete throughout; the Examples section covers the common user asks. | 5 / 5 |
Workflow Clarity | Eight explicitly sequenced phases with hard validation gates: STOP on empty critical set before any phase, blocked/caution/ready verdict rules before editing, Phase 5 requires the user's explicit confirmation before any edit, Phase 6 re-searches for the key and mandates build/lint/tests with 'fix any failures before moving on' (a validate→fix→retry loop), and Phase 7 confirms before pushing. Checklists are provided for the plan and the PR description. | 5 / 5 |
Progressive Disclosure | SKILL.md is a clear overview, details are split one level deep into signaled references ("Load [readiness.md](references/readiness.md) before giving a verdict"), and the in-bundle readiness.md is real and well-scoped. Not 5 because four of the five referenced paths (tool-map.md, sdk-patterns.md, write-safety.md, scope-establishment.md) point outside the skill's own directory via `../../../` into a shared tree and could not be verified to resolve from this bundle — a minor organization/portability gap on top of otherwise excellent structure. | 4 / 5 |
Total | 18 / 20 Passed |