Content
100%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 conventions skill that models what dense, token-efficient instruction looks like: every rule is stated with the exact module, function, or test that implements and enforces it, and a Verification section closes the loop with explicit checkpoints. It is an instruction-only skill, but its concrete API names, enumerated per-screen cases, and guard tests make the guidance fully actionable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every bullet is a rule that names exact modules and functions ("src/hints.rs", "ui/hint_line.rs draw, draw_clipped, line, spans, styled", "list_nav::digit"), with zero padding and no explanation of concepts Claude already knows — Ratatui itself is never introduced. Nothing here could be trimmed without losing a real constraint, matching the lean-and-efficient anchor. | 5 / 5 |
Actionability | For an instruction-only skill the guidance is maximally concrete: named helpers with their contracts ("step(down, len, wrap, selectable)"), enumerated per-screen cases ("/model and /thinking: Enter or s; /resume: Enter or d; /mcp: Enter, d or e"), and guard tests that enforce the rules ("tests/units/color_literals.rs"). The enumerated common cases leave no gap between rule and execution, so it sits at the top anchor rather than 4. | 5 / 5 |
Workflow Clarity | The rules themselves are unambiguous (the single-action exception applies to each rule), and the Verification section supplies explicit validation checkpoints: update affected client-e2e scenarios, regenerate goldens, and extend the named unit tests when a helper changes. It also includes error-recovery guidance ("Do not add exemptions to make it pass: move the color into src/ui/theme/"), fitting the explicit-validation anchor rather than the minor-gaps anchor at 4. | 5 / 5 |
Progressive Disclosure | The body is a compact set of well-organized sections with details correctly delegated one level deep to clearly signaled repo files ("Local code rules, scenarios and goldens live in vibe/cli-rust/AGENTS.md and client-e2e/AGENTS.md", repeated in Verification). No nesting beyond one level, no inlined material that belongs elsewhere, and easy navigation across the eight sections. | 5 / 5 |
Total | 20 / 20 Passed |