Content
81%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 highly actionable, well-gated procedural skill with executable scripts and strong validation/feedback loops. Its main weakness is token efficiency from duplicating the plugin-root resolution script across steps.
Suggestions
Extract the repeated valid_root plugin-root resolution block into a sourced helper script (e.g. scripts/resolve-plugin-root.sh) and call it from Step 3 and Step 5 instead of inlining the ~40 lines twice.
Tighten the Step 0 narration-rules section by collapsing the violation/normal example blocks into a single compact do/don't pair to reduce token weight.
Consider moving the large per-step bash blocks into a scripts/ companion so SKILL.md reads as an overview with one-level-deep references, improving progressive_disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Operational prose is tight and assumes Claude's competence (no basic-concept padding), but the ~40-line valid_root plugin-root resolution script is duplicated verbatim in Step 3 and Step 5, which is avoidable token cost that 'could be tightened' into a sourced helper. | 3 / 5 |
Actionability | Every step ships a complete, copy-paste-ready bash block with real commands (git worktree add, cherry-pick, contract-grep gates) and concrete error/exit-code handling, covering the common cases fully executably. | 5 / 5 |
Workflow Clarity | Steps 0–8 are explicitly sequenced with validation checkpoints at every risky point (pre-check, commit-count guard, Plans.md precondition, contract-grep gates, conflict abort) and feedback loops (retry once, REQUEST_CHANGES, ABORT) for a destructive-to-main operation. | 5 / 5 |
Progressive Disclosure | Clean section headers and one well-signaled one-level-deep reference (references/cursor-cli-only.md, a real file) with a Related Skills map, but the bulk of the workflow and bash logic lives inline in SKILL.md rather than being split out. | 4 / 5 |
Total | 17 / 20 Passed |