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.
An exemplary orchestrator skill body: concrete formats and capability names throughout, a 9-step procedure with validation and idempotency gates at every risky point, a clearly separated blocked/error protocol, and well-signaled one-level references that all exist in the bundle. The only real costs are moderate rule repetition and some per-mode detail that could live in the reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes competence — no generic concepts are explained, and nearly every sentence carries operational rules (exact JSON shapes, state names, exact output format). However, several rules are restated multiple times ('state is the source of truth'/claimMarker handling appears in the --list mode, step 2, and the invariant; the dependency gate is described in three places), which is repetition that could be tightened. This fits the 'efficient; minor instances that could be trimmed' anchor rather than the lean level-5 anchor, and is far above the noticeably-verbose level 3. | 4 / 5 |
Actionability | Guidance is fully concrete and executable: the exact cursor JSON shape, the exact --list output format ('[{"id","sites"}]', no prose, no fences), exact capability names (fetchQueue, getItem, setState, attachLink), exact transition rules, and the exact final blocked line 'TRIAGE_BLOCKED: <one-line reason>'. Per the scoring notes, absence of code in an instruction-only skill is not penalized when the guidance is this actionable. | 5 / 5 |
Workflow Clarity | The 9-step procedure is clearly sequenced with explicit validation checkpoints at every risky point: a re-fetch idempotency gate at claim, the dependency gate applied at both --list and claim, skip conditions enumerated per step, a dedicated Blocked protocol with stop-and-surface feedback, and explicit post-hoc sync-back/transition rules per outcome. Despite being a batch operation, validation is pervasive, so the batch cap does not apply — this matches the top anchor with feedback loops and explicit checkpoints. | 5 / 5 |
Progressive Disclosure | A clear overview with a 'Read first' section that well-signals all three real, one-level-deep reference files (references/config-schema.md, work-item-schema.md, tracker-binding.md — all present in the bundle) with a one-line purpose each, and config/state files clearly separated from the skill bundle. It falls short of the top anchor because some reference-worthy detail (the full --list output spec, the dependency-gate statusType semantics, and the Linear relation API details) is inlined in SKILL.md rather than pushed into the existing references. | 4 / 5 |
Total | 18 / 20 Passed |