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-orchestrated command skill: lean, clearly sequenced, with failure-stop and merge-confirmation checkpoints in all the right places. The main weaknesses are executable gaps in the spawn/eval steps, an undocumented --judge flag in a usage example, and script references that do not resolve within this skill's bundle.
Suggestions
Document the --judge flag in the Parameters table (or remove it from the fourth usage example), since it is currently used without explanation.
Give the concrete invocation for /hub:spawn, /hub:eval, and result_ranker.py (arguments, expected invocation shape), or explicitly state that each sub-skill's SKILL.md defines its own exact usage.
Resolve the dangling script paths: {skill_path}/scripts/hub_init.py and result_ranker.py do not exist in this skill's bundle — either include the scripts or point to the owning skill's actual paths.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: four usage examples that each demonstrate a distinct mode, a compact parameter table, six terse numbered steps, and a short rules list. It assumes Claude's competence (no explanation of what metrics, merging, or parallelism are); the only marginal aside is "(true parallelism)", which still carries information. Every section earns its tokens. | 5 / 5 |
Actionability | Step 1 gives a concrete bash command and Step 2 gives exact sub-steps, but Step 3 ("Run /hub:spawn with the session ID") and Step 5 ("metric-based ranking with result_ranker.py") provide no executable invocation, and the fourth usage example passes a --judge flag that the Parameters table never documents. Guidance is mostly executable with minor gaps, matching the score-4 anchor rather than the fully copy-paste-ready score-5 anchor. | 4 / 5 |
Workflow Clarity | The six steps are explicitly sequenced with "each step depends on the previous", and validation checkpoints are present: "Stop on failure — if any step fails, report the error and stop", baseline capture for delta comparison, and "User confirms merge — never auto-merge without asking" gates the destructive merge. This satisfies the batch/destructive-operation validation requirement rather than triggering the cap at 3. | 5 / 5 |
Progressive Disclosure | The body is well sectioned (Usage, Parameters, What It Does, Critical Rules) and delegates stage details to the sub-skills it invokes, with one-level-deep, clearly signaled references ("../agenthub/references/agent-templates.md"). However, scored against the actual bundle — which has no scripts/ directory — the paths {skill_path}/scripts/hub_init.py and result_ranker.py are dangling, keeping it just below the well-resolved score-5 anchor. | 4 / 5 |
Total | 18 / 20 Passed |