Content
92%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 high-quality skill body: executable commands throughout, explicit safety gates and validation checkpoints for a destructive workflow, and lean repo-specific knowledge. The one improvement area is showing the changeset file format in step 4.
Suggestions
In step 4, include a short example of the consolidated .changeset/*.md file (frontmatter with patch bumps and message body) so the created changeset is copy-paste ready like the rest of the workflow.
Trim redundant parentheticals in step 4, e.g. "(removed/unused upstream)" alongside the later "a pre.json field Changesets v3 no longer reads", which repeats the same deprecation rationale twice.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean sections of commands and tables with no explanation of concepts Claude already knows; the dense prose in step 4 (Changesets v3 pre.json behavior, deprecated baseline script) is version-specific knowledge Claude cannot infer, so every token earns its place. | 5 / 5 |
Actionability | Copy-paste bash blocks at every step and a conflict-to-exact-command table (e.g. `git checkout --ours "packages/*/package.json"`) make the workflow mostly executable; the minor gap is that the consolidated `.changeset/*.md` file to create in step 4 is described but its format is never shown. | 4 / 5 |
Workflow Clarity | A six-step sequence with explicit gates (dirty-tree stop, branch confirmation), pre-push validation (`git diff --stat origin/$BRANCH...HEAD`, `git push --force-with-lease --dry-run`), a troubleshooting feedback table, and an Expected Output checklist — full validation for a destructive force-push operation. | 5 / 5 |
Progressive Disclosure | Well-organized sections with no monolithic wall of text; the single bundle reference (scripts/generate-rebase-report.cjs) exists in the bundle, is well-signaled with its invocation path, and its generated report is read one level deep from .tmp/skills/custom-rebase/. | 5 / 5 |
Total | 19 / 20 Passed |