Content
92%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 single-file skill body: fully executable commands, explicit validation and recovery loops for install/auth, precise output-formatting rules, and tight guardrails. The only improvement is deduplicating the silence rule between the intro and Output Handling sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — no concept explanations, just commands, error paths, and formatting rules. The only trimmable redundancy is the silence rule stated in the intro ("Stay silent while an active review is running") and repeated twice in Output Handling ("Do not emit intermediate waiting or polling messages"), which fits anchor 4 (minor instances that could be trimmed) rather than 5. | 4 / 5 |
Actionability | All guidance is copy-paste executable: `coderabbit --version`, `curl -fsSL https://cli.coderabbit.ai/install.sh | sh`, `coderabbit auth status --agent`, and four concrete review-scope variants. Output handling and result formatting rules are equally specific (severity order, "❗ Critical" emoji format, "use 'issues', not 'findings'", 10-minute health window). Matches anchor 5. | 5 / 5 |
Workflow Clarity | Prerequisites form a clear sequence with explicit validate-then-retry loops: check CLI → install → "re-run `coderabbit --version` to confirm", and check auth → login → "re-run `coderabbit auth status --agent` and only continue to review commands after authentication succeeds". Timeout handling ("Only report timeout or failure after the full 10-minute window has elapsed") and error reporting with user-facing remediation complete the checkpoints. The destructive/batch cap does not apply since review is read-only; matches anchor 5. | 5 / 5 |
Progressive Disclosure | This is a single-purpose, self-contained skill with no bundle files (no references/, scripts/, or assets/ exist) and no need for external references. The ~80-line body is cleanly organized into five well-labeled sections (Prerequisites, Review Commands, Output Handling, Result Format, Guardrails) with no nesting, so per the simple-skill guidance it scores at the top. | 5 / 5 |
Total | 19 / 20 Passed |