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-only skill body: executable commands with fallbacks, an explicit validate-fix-retry loop, a complete failure protocol, and tight phase-organized sections with no wasted tokens. All four dimensions sit at the top anchors.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean operational runbook with zero concept explanations and no padding — every line is an instruction, command, or decision rule. The few why-clauses (e.g. "this prevents another agent or engineer from picking up the same task concurrently") are single-sentence, load-bearing rationales that prevent steps from being wrongly skipped, not over-explanation, so it sits at anchor 5 rather than anchor 4. | 5 / 5 |
Actionability | Fully executable throughout: copy-paste git worktree commands, ./gradlew spotlessApply/spotlessCheck/module test commands, the exact gh api POST endpoint (with an explicit REST fallback), named workflow files to dispatch, per-section PR template fill-in rules, and a concrete failure protocol. Placeholders like <short-desc> and <affected-module> are appropriate parameterization, not pseudocode — matching anchor 5. | 5 / 5 |
Workflow Clarity | A clearly sequenced lifecycle (claim → implement → verify → PR → post-PR) with an explicit validation checkpoint ("If any check fails due to your changes, fix it and re-run before proceeding. Do not open a PR with known failures") and a full error-recovery path in 'If stuck' (comment, move back to Ready, clean up worktree, no partial PR, report). This is a direct match to anchor 5's explicit validation, feedback loops, and structured error handling — the destructive worktree removals are all gated behind these checks, so no cap applies. | 5 / 5 |
Progressive Disclosure | No bundle files exist, and none are needed: the ~90-line body is organized into six clean phase sections with nothing inlined that belongs in a separate file. References that do appear (AGENTS.md, .github/PULL_REQUEST_TEMPLATE.md, the ddg-asana skill) are one level deep, well-signaled pointers into the target repo, matching anchor 5's clear structure and easy navigation. | 5 / 5 |
Total | 20 / 20 Passed |