Content
92%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 tight, highly actionable orchestrator skill body with concrete commands, gated outward actions, explicit validation, and clean one-level-deep references. Only minor redundancy between inline rules and the consolidated 'Iron rules' section keeps conciseness just off the top anchor.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and assumes Claude's competence — no padding explaining GitHub/issues — but the 'Iron rules' section restates invariants already stated inline in Steps 2 and 5 (injection guard, force-push), adding minor redundant tokens. | 4 / 5 |
Actionability | Fully executable guidance for an instruction-only skill: concrete `gh issue view <n> --json ...` commands, literal spec path `.hyperflow/specs/issue-<n>-<slug>.md`, branch naming `feat/issue-<n>-<slug>`, and a copy-paste `Skill` invocation with explicit args. | 5 / 5 |
Workflow Clarity | Steps 0–5 are clearly sequenced with explicit validation checkpoints (auth check, closed-issue confirm, already-solved check) and an error-handling table providing feedback loops for gh-missing, not-found, rate-limited, and headless cases; outward actions are gated. | 5 / 5 |
Progressive Disclosure | SKILL.md is a concise overview with well-signaled one-level-deep references to sibling materials (task-triage.md, trace/dispatch/pr SKILL.md, DOCTRINE/git-workflow/output-style); appropriately no inlined bulk content and no bundle files needed for an orchestrator. | 5 / 5 |
Total | 19 / 20 Passed |