Content
78%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 dense, high-signal rulebook: every section pairs concrete project invariants with named regression tests, and structure is appropriate for a short no-bundle skill. The only recurring weakness is sentence-level density — several bullets are overlong single sentences that could be split for readability without adding tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every token carries project-specific facts Claude could not know (internal package names, issue numbers, test names) with zero padding or explanation of known concepts, which is efficient. A few bullets are 100+ word single sentences with stacked clauses (e.g., the worktree_roots bullet) that could be tightened, keeping it below the lean-everywhere anchor. | 4 / 5 |
Actionability | Concrete, executable guidance throughout — 'Route every gate git call through git.Run', 'Edit internal/skill/skill.go, then run make skill', 'use git.RunBare', 'route through the shared prSelector' — with specific files, commands, and fail-closed rules. Some bullets state policy without an executable command, so it is not fully copy-paste-ready. | 4 / 5 |
Workflow Clarity | This is a per-subsystem rulebook rather than a multi-step workflow, and each section names its regression tests (e.g., 'Regressions: TestPostReceiveHook_ResolvesAbsoluteGateDir'), supplying most validation checkpoints. No fix-and-retry loop is spelled out, so it stops short of the explicit-validation anchor. The destructive-operations cap is not triggered: the skill explicitly mandates refusal and fail-closed behavior for the risky operations it governs. | 4 / 5 |
Progressive Disclosure | The ~28-line body is organized into clear bolded section headers with no bundle files needed, and its single external reference (docs/src/content/docs/reference/global-config.md) is clearly signaled and one level deep — matching the under-50-line, well-organized exception. | 5 / 5 |
Total | 17 / 20 Passed |