Content
75%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 body in terms of token efficiency and internal structure — tables, terse examples, honest limitations, no padding. Its main defect is that the core script it instructs users to copy and edit (quality-gate.py) is not actually bundled, leaving the install and configuration steps unexecutable; a post-install verification step is also missing.
Suggestions
Bundle quality-gate.py in scripts/ (and reference it as scripts/quality-gate.py) so the install and configuration steps are actually executable.
Add a short verification step after install (e.g., echo a fake transcript to the hook or run it manually to confirm exit 0) to close the validation gap.
Reconcile naming: the skill is 'delivery-gate' but the script and install references are 'quality-gate.py' — pick one name to avoid confusion.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and dense: behavior is conveyed through tables (checks/mechanisms/on-hit, config variables), a copy-paste install block, and terse exit-code examples. It never explains concepts Claude already knows, and every section (checks, why, install, config, examples, limitations) earns its place — matching anchor 5 rather than anchor 4's 'minor instances that could be trimmed'. | 5 / 5 |
Actionability | Concrete elements are strong — exact `cp` command, ready settings.json hook config, a config-variable table, and worked examples with exit codes and stderr text — but the entire skill depends on `quality-gate.py`, which is referenced ('cp quality-gate.py ~/.claude/scripts/', 'Edit quality-gate.py') yet absent from the bundle (no scripts/ directory). That is a key missing detail, so anchor 3 fits better than anchor 4's 'minor gaps'. | 3 / 5 |
Workflow Clarity | The install workflow (copy script → register Stop hook in settings.json → create learning-library files → customize LIBS) is clearly sequenced, and the Examples section documents expected exit-code outcomes for each scenario, acting as informal checkpoints. It lacks an explicit post-install validation step (e.g., test-fire the hook or run it on a fake transcript), which keeps it at anchor 4 rather than anchor 5. | 4 / 5 |
Progressive Disclosure | Well-organized sections with appropriately sized inline content and clearly signaled cross-references ('See Also' listing self-audit, verification-loop, gateguard), and the bundle contains no nested or buried references. However, the one hard file dependency, quality-gate.py, does not exist in the bundle, a real organization gap that anchor 5's 'easy navigation' would not have. | 4 / 5 |
Total | 16 / 20 Passed |