Content
88%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 well-engineered orchestrator skill: deterministic decision logic is delegated to real bundled scripts, the polling loop is precisely specified with executable commands, and destructive operations are guarded by explicit gate checks and validation. The body is efficient with only minor duplication between the status tables, the inline tool-call list, and references/fix-flows.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — configuration tables, state variables, exact script invocations — with no padding or explanation of concepts Claude already knows. Minor trimming opportunities exist (per-status behaviors appear in the summary table, the 'Tool calls for actions' list, and references/fix-flows.md), keeping it just below the 'every token earns its place' anchor. | 4 / 5 |
Actionability | Fully executable guidance: exact script calls with every flag (ci-poll-decide.mjs with its full argument list), concrete MCP tool invocations with field sets (WAIT_FIELDS/LIGHT_FIELDS/HEAVY_FIELDS), exact status codes with default behaviors, and an error-handling table with recovery actions. Not a 4 because there are no missing key details — the common cases are covered copy-paste ready. | 5 / 5 |
Workflow Clarity | Steps 0–4 are clearly sequenced with explicit validation checkpoints: connection check before the loop, cycle-check run before handling any actionable status, gate checks (ci-state-update.mjs gate) before destructive git operations, local-verify-then-apply feedback loops, circuit breaker and no-progress tracking, and a full error-recovery table. Matches the top anchor with feedback loops for error recovery. | 5 / 5 |
Progressive Disclosure | Good structure: references/fix-flows.md is one level deep, clearly signaled ('read references/fix-flows.md for the detailed flow'), and both referenced scripts (ci-poll-decide.mjs, ci-state-update.mjs) exist in the bundle. Minor gaps: some per-status detail (MCP field lists, tool calls per status) is duplicated inline in SKILL.md rather than fully delegated to the reference, so it falls just short of the ideal split. | 4 / 5 |
Total | 18 / 20 Passed |