Content
96%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 excellent, lean operational runbook: concrete copy-paste commands, a clearly sequenced workflow with built-in verification and safety red lines, and no filler. The only structural improvement is splitting the deeper detail (pane deep dive, failure-domain specifics) into one-level-deep reference files.
Suggestions
Move the Named-Agent Pane Deep Dive procedure and the Failure Domains detail into a single one-level-deep reference file (e.g. references/pane-inspection.md), keeping a short trigger summary inline in SKILL.md.
Include the literal tmux capture commands (e.g. the specific capture-pane invocation with bounds) alongside the pane-inspection steps so that stage is as copy-paste ready as the ccb commands.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean, imperative runbook with zero padding: "Do not conclude `ok` from successful `ccb` command exit codes alone" and "Old pane text is evidence of residue until the current lineage is proven" convey dense operational rules with no explanation of concepts Claude already knows. Every section earns its tokens, matching the anchor-5 lean-and-efficient profile. | 5 / 5 |
Actionability | Copy-paste-ready commands cover the common cases: `ccb ping ccbd`, `ccb doctor`, `ccb ps`, `ccb queue --detail all`, `ccb pend --inbox --detail <agent>`, `ccb trace <job_id|message_id|attempt_id|reply_id>`, `ccb config validate`, `ccb reload --dry-run`, plus a concrete report template and named handoff targets (`ccb-self-recover`, `ccb-self-chain`, `ccb-config`). It is not anchor 4 because the guidance is fully executable rather than having minor gaps. | 5 / 5 |
Workflow Clarity | The Core Workflow is a clear numbered sequence with explicit validation checkpoints and feedback loops: compare normalized fingerprints after an interval to classify progress versus a frozen screen, "run `ccb config validate` first, then `ccb reload --dry-run`", report a blocker when the full artifact is absent, and rate confidence. The skill is read-only triage, so the destructive/batch-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | Sections are well-organized (Evidence Model, Core Workflow, Pane Deep Dive, Failure Domains, Reporting, Red Lines) with no nested-reference risk and no broken references, matching anchor 4. It is not 5 because the body is ~127 lines with everything inline and no one-level-deep reference files; the under-50-lines exception for a 5 on organization alone does not apply, and the pane deep-dive detail is a natural candidate for a separate reference. | 4 / 5 |
Total | 19 / 20 Passed |