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 lean orchestrator body: crisp two-branch dispatch with concrete file targets, an explicit stop-and-escalate error-handling loop, and appropriately deferred detail via one-level-deep references. The only deductions are a small ambiguity when no phase is requested and the fact that the referenced bundle files (commands/, skills/controller.md, guidelines.md) were not present to verify.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~20-line body is lean and assumes Claude's competence — it dispatches via "read `commands/{command}.md` and follow it" and "read `skills/controller.md` to load the workflow controller" with zero padding or explanation of concepts Claude already knows. Every token earns its place, matching the score-5 anchor. | 5 / 5 |
Actionability | Guidance is mostly executable with concrete file paths and unambiguous conditionals ("If the user invoked a specific command... read `commands/{command}.md`", "If the user provided a Jira issue key or URL, execute the `/ingest` phase"), matching the score-4 anchor for an instruction-only skill. It is not 5 because "execute the first phase the user requests" leaves a gap when the user requests no phase, and per-phase specifics are delegated without any inline example of what execution looks like. | 4 / 5 |
Workflow Clarity | The dispatch sequence is clear and includes an explicit validation/feedback checkpoint: "If a step fails or produces unexpected output (e.g., Jira MCP errors, network failures...), stop and report the error to the user. Do not advance to the next phase. Offer to retry the failed step or escalate." This matches the score-5 anchor (clear sequence, explicit error-recovery loop); the destructive/batch cap does not apply because the body itself performs no batch operations and includes failure handling. | 5 / 5 |
Progressive Disclosure | The body is a clean overview with well-signaled, one-level-deep references — "read `commands/{command}.md`", "read `skills/controller.md`", and "For principles, hard limits, safety, quality, and escalation rules, see `guidelines.md`" — which structurally matches the score-5 anchor. However, no bundle files were provided (no references/, scripts/, assets/, commands/, skills/, or guidelines.md exist in the skill directory), so the referenced files cannot be verified to exist, keeping this at 4 rather than 5. | 4 / 5 |
Total | 18 / 20 Passed |