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.
A tight, well-structured instruction body: every step is concrete and executable, with explicit error handling, install/auth gating, and a fallback chain for the review command. The single deduction is progressive disclosure, where the flat single-page structure sits just above the simple-skill line. No bundle files exist, so structure is judged on the SKILL.md body alone.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every step is a one-line instruction plus the exact command ('git rev-parse --show-toplevel', 'command -v greptile', 'greptile review --json'), with zero padding and no explanation of concepts Claude already knows. Matches the 'lean and efficient; every token earns its place' anchor; level 4 would require trimmable over-explanation, which is absent. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready commands at every step, including the npm install, the curl shell-installer fallback, and the '--agent' fallback when '--json' fails. Matches the level-5 anchor covering the common cases; not 4 since no key executable detail is missing. | 5 / 5 |
Workflow Clarity | Clear five-step sequence with explicit checkpoints and feedback loops: failure handling at repo check, CLI presence, auth ('Wait for the user to complete the login flow'), a fallback command on usage error, and 'Do not hide the raw command failure if both commands fail' for error recovery. Not a destructive or batch operation, so the level-3 cap does not apply; matches the level-5 anchor. | 5 / 5 |
Progressive Disclosure | Well-organized into five clearly headed sections with nothing that warrants splitting into separate files, and no buried or nested references. Held at 4 rather than 5 because the body (~83 lines) exceeds the under-50-line threshold where flat structure alone earns top marks, and no reference-based organization is demonstrated. | 4 / 5 |
Total | 19 / 20 Passed |