Content
82%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-structured skill body that gives concrete git commands and templates for a destructive workflow. The main gaps are a slightly implicit error-recovery feedback loop and all content being inline with no bundle references.
Suggestions
Make the validation feedback loop explicit in step 6, e.g. 'If build/tests fail, fix in the split branch and re-run before proceeding — do not advance until verification passes.'
Tighten the Changesets section by merging each point's restatement into a single directive to reduce redundancy.
Consider extracting the scratchpad and PR-description templates into a references file so SKILL.md stays a lean overview pointing one level deep.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and instructional, assuming Claude's knowledge of git and PRs without padding; minor redundancy in the Changesets section (e.g. restating 'scope the message to that PR's changes only' with an explanatory sentence) keeps it just below the lean anchor-5. | 4 / 5 |
Actionability | Provides copy-paste-ready commands throughout — 'git branch backup/original-large-pr', 'git checkout backup/original-large-pr -- path/to/file', 'git restore -p --source backup/original-large-pr -- path/to/file', 'git range-diff', 'pnpm changeset -s -m "..."' — plus complete PR-description and scratchpad templates covering the common cases. | 5 / 5 |
Workflow Clarity | An 8-step sequenced workflow with explicit verification (step 6: build/typecheck/lint/tests) and range-diff checks (step 8), plus a scratchpad checklist; however the validate→fix→retry feedback loop is implied rather than spelled out, and for a destructive history-rewriting skill that minor gap keeps it below anchor 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist, so all content lives inline in SKILL.md, but it is well-organized into clearly headed sections (Required workflow, PR description pattern, Scratchpad template, Changesets, Common failure modes, Default output) with no nested references; good structure with minor organization gaps rather than the clear one-level-deep reference split of anchor 5. | 4 / 5 |
Total | 17 / 20 Passed |