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 lean, tightly written operational skill body that routes each task to an authoritative reference with explicit exit-code and refusal semantics. The main gaps are inline commands for the hook install/disarm workflow and two referenced files (CHECKS.md, kendex.settings.toml.example) missing from the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~30-line body is dense and pointer-heavy with zero padding: a four-command quick-start block, exit codes, and conditional 'read X before Y' routing, with no explanation of concepts Claude already knows. Every token carries operational information; only the Git 2.45.1 version-pin sentence borders on the time-sensitive-info concern. | 5 / 5 |
Actionability | The quick-start block ('commit-guards all --staged', '--base origin/main', 'CHECK --help', 'md-reflow PATH...') is copy-paste ready and exit codes 0/1/2 plus concrete push-refusal conditions give executable semantics. Hook install/disarm commands are delegated to 'scripts/install-git-hooks --help' and DEVELOPMENT.md rather than shown inline, leaving minor gaps. | 4 / 5 |
Workflow Clarity | Each task path is unambiguously routed (read CHECKS.md before tuning a check, read hooks-and-settings.md before changing setup, refuse a push whose tip is not HEAD), and validation semantics are explicit via exit codes and collection-error handling. There is no end-to-end sequenced workflow with feedback loops for the install path — it delegates to --help and the DEVELOPMENT.md contract. | 4 / 5 |
Progressive Disclosure | Structure is exemplary: quick-start inline, three well-labeled sections each pointing to one-level-deep references with specific anchors (references/hooks-and-settings.md exists and matches its cited sections). However, CHECKS.md — described as owning all check contracts — and kendex.settings.toml.example are referenced but absent from the bundle, so two central pointers dangle. | 4 / 5 |
Total | 17 / 20 Passed |