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.
An exemplary instruction skill body: concise, fully actionable, with sequenced workflows that include validation and error-recovery feedback loops, and a clean one-level-deep reference structure whose files all exist.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient throughout: no generic explanations of git or PRs, every line teaches a non-obvious behavior (TTY detection, exit codes, merge semantics). Every token earns its place. | 5 / 5 |
Actionability | Fully executable copy-paste-ready commands for setup, the core loop, sync, and merge, plus a concrete JSON schema for parsing `view --json` and an explicit always/never-run command table covering common cases. | 5 / 5 |
Workflow Clarity | Multi-step processes are clearly sequenced with explicit validation and feedback loops: the Exit 3 recovery loop, the sync-divergence ("Sync aborted") handling, the unstack-then-retry checkout flow, and the all-or-nothing merge semantics. | 5 / 5 |
Progressive Disclosure | Clear overview in SKILL.md with three well-signaled one-level-deep references (stack-design.md, commands.md, troubleshooting.md), each mapped to a specific trigger; all referenced files exist in the bundle and content is appropriately split. | 5 / 5 |
Total | 20 / 20 Passed |