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 lean, highly actionable instruction skill: an explicit trigger, a decision checklist, concrete command forms with heredocs, error-recovery paths, and a defined end-state. Its only real weakness is the long flat Guardrails list, which repeats a couple of `--chain` rules and would benefit from grouping.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense operational guidance ("Default: do not use `--chain`", "Finish an inbound CCB task in its current turn") with no padding explaining concepts Claude already knows. Minor trimming is possible — the `--chain` dependency rule is restated in several guardrail bullets ("Never add `--chain` merely to make a rejected plain ask succeed", "Use `--chain` only for a real child dependency") — which keeps it below a 5. | 4 / 5 |
Actionability | Copy-paste-ready command templates ("command ask --chain --artifact-reply \"$TARGET\" <<'EOF'"), exact flag semantics, a quoted error string to react to ("If CCB says `ask --chain requires an active parent job`, retry once with plain `ask`"), and a concrete correction command (`ccb followup <active_job_id> --message ...`) with success/failure states. It fully specifies what to execute and what to do on each outcome. | 5 / 5 |
Workflow Clarity | A numbered Decision Card checklist (need delegation → dependency gate → result intent → request fidelity) sequences the decision, guardrails cover error recovery (retry with plain `ask`, `injected` vs `rejected`/`too_late`/`terminal` handling), and the post-command instruction ("end the turn. Do not wait for a reply ... do not poll") closes the loop. Checklists plus explicit feedback loops match the top anchor. | 5 / 5 |
Progressive Disclosure | No bundle files exist, and the body is organized into clear sections (trigger, Decision Card, Guardrails, templates, post-command behavior) with no nested references. The ~20-bullet Guardrails wall is one block that could be grouped into sub-sections (chain rules, artifact rules, diagnostics) for easier scanning, which keeps it below a 5. | 4 / 5 |
Total | 18 / 20 Passed |