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.
An excellent internal maintenance skill: highly actionable commands, dense non-obvious repo knowledge, explicit verification steps, and well-organized sections. Its only weaknesses are mild — some rationale clauses could be tightened, error recovery is consolidated in Gotchas rather than inline, and the long body has one plausible split point for a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and repo-specific throughout — the pin-partner table, "GitHub's source archives are generated on demand and not byte-stable", and the gotchas are all knowledge Claude could not already have, with no generic concept explanations. A few long justifying clauses (e.g., the git-vs-archive checksum rationale) could be trimmed, so it sits at the 4 anchor rather than the 5 anchor's every-token-earns-its-place. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands cover the common cases: "./scripts/check-upstream.sh sqlite --apply", "git ls-remote <repo> 'refs/tags/<version>*'", "make prepare-src download-sqlite download-sqlean", "python setup.py build_ext -i", "python -m tests". Required edits are tied to exact files (Makefile pins, setup.py, PLATFORMS), matching the 5 anchor. | 5 / 5 |
Workflow Clarity | The bump flow is sequenced (resolve via script or by hand, then a Verify section running the full build/test chain) with the automated check-sqlean-pin checkpoint and error-recovery guidance ("Regenerate it against sqlite/time/duration.c", "touch src/sqlean.c after editing"). Recovery guidance lives in a separate Gotchas section rather than inline validate-fix-retry loops, and steps are not given as an ordered list, so it fits the 4 anchor rather than the 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist and none are needed; sections (Bumping / Staying current / Gotchas / Wheels and publishing) are well-organized with clear headers and the body's script mentions are repo paths, not dangling references. At ~135 lines the wheels-and-publishing detail could arguably be split into a reference file, which is the minor organization gap of the 4 anchor rather than the 5 anchor's fully appropriate split. | 4 / 5 |
Total | 17 / 20 Passed |