Content
96%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.
An exemplary instruction-only skill body: executable commands, explicit preconditions and validation checkpoints, safety rationale for the destructive force-push, and tight, unpadded prose. The only notable weakness is the duplicated branch-prefix table, which reproduces an in-repo canonical list.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operational throughout — commands, a compact prefix table, preconditions, and a checklist — with no explanations of concepts Claude already knows. Even the force-push paragraph earns its place by explaining a non-obvious failure mode ("the lease is intact and the wrong branch gets rewritten"), matching anchor 5. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready commands in both recipes (`git fetch upstream --prune --tags`, `git switch -c <branch-name> upstream/main`, `gh pr checkout <NNNN>`, `git push --force-with-lease`) plus concrete verification commands and real example slugs like `fix/r8-animation-release` — anchor 5. | 5 / 5 |
Workflow Clarity | Preconditions with verification commands (`git status --porcelain`, `git remote -v`), a numbered recipe with a sanity check, a rebase variant with explicit pre-push validation ("confirm this is the PR you meant, before any push"), conflict-resolution feedback, and a post-branch checklist. The destructive force-push is well guarded, so the cap does not apply — anchor 5. | 5 / 5 |
Progressive Disclosure | Well-organized single-topic sections with one-level-deep, clearly signaled references (`.specify/memory/constitution.md`, `AGENTS.md`, `CLAUDE.md`), no bundle files needed. Minor gap: the 9-row prefix table duplicates the in-repo canonical list that constitution.md and CONTRIBUTING.md already carry, adding a fourth copy with drift risk — anchor 4 rather than 5. | 4 / 5 |
Total | 19 / 20 Passed |