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.
The body is an exemplary CLI-operation skill: lean, command-first, and version-aware (deferring to installed help and official docs), with clear sequencing, explicit validation and destructive-operation checkpoints, and a clean split between the overview and two real one-level-deep reference files. No dimension shows meaningful weakness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~130 lines of terse directives and command blocks with zero concept explanations Claude already knows — even the safety framing is compressed ("Do not describe `--always-approve` as equivalent to sandboxing") — so every token earns its place (anchor 5), not anchor 4 since no padding is trimmable. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready commands cover the common cases: `command -v grok`, the complete headless invocation with `--no-auto-update --cwd --sandbox -p ... --output-format json`, `grok --worktree --ref main "Fix the flaky test"`, and `grok worktree rm --dry-run <id>` — a clear anchor 5 match. | 5 / 5 |
Workflow Clarity | The evidence-first sequence (1-4: verify binary, inspect help, inspect config, defer to installed docs) includes explicit validation and a failure feedback loop ("if missing, stop and give install or auth guidance"), plus checkpoints for destructive operations ("Preview removal with `grok worktree rm --dry-run <id>` before deleting", "Verify destructive commands such as session deletion... before running them"), so the destructive-operation cap does not apply — anchor 5. | 5 / 5 |
Progressive Disclosure | The body is a genuine overview with two well-signaled, purpose-stated, one-level-deep references ("Read [references/cli-reference.md](references/cli-reference.md) for the subcommand and common flag index", "Read [references/workflows.md](references/workflows.md) for headless execution, sessions, worktrees..."); both files exist and nest no further — anchor 5. | 5 / 5 |
Total | 20 / 20 Passed |