Content
81%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 strong operational skill: the workflow is clearly sequenced with explicit verification and authorization gates around risky actions, and the guidance is largely concrete and executable. Weaknesses are minor — some repetition of the evidence-vs-authority rule across sections and unspecified arguments in the repair subcommands — plus the pane-state taxonomy being inlined in an otherwise monolithic file.
Suggestions
State the 'pane text/screenshots/queue summaries are evidence, not authority' rule once in Red Lines and reference it from steps 1–3 instead of restating it three or four times, trimming several lines.
Specify the argument shapes for 'ccb repair ack', 'ccb repair retry', and 'ccb repair resubmit' (or note explicitly where argument details come from, e.g. 'ccb repair ack --help' / the trace output) so the recovery commands are executable rather than ellipsis templates.
Move the pane-state taxonomy (the eight 'working/waiting_input/...' definitions) and the classification output template into a one-level-deep reference file (e.g. references/pane-states.md), keeping SKILL.md as a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence — it explains only environment-specific CCB conventions, not general concepts. However, the 'pane text/evidence is not authority' rule is restated in steps 1, 2, 3, and again in Red Lines, and a few qualifiers ('Do not infer an all target', 'previews are not authority') could be consolidated, which fits the score-4 anchor (efficient with minor over-explanation to trim) rather than the lean score-5 anchor. | 4 / 5 |
Actionability | Concrete executable commands throughout ('command ccb ping ccbd', 'ccb queue --detail "$AGENT"', exact tmux capture commands, the gh issue create example, and a concrete output template), but the repair commands 'command ccb repair ack ... / retry ... / resubmit ...' use unspecified ellipsis arguments rather than executable forms. That is a minor gap, matching the score-4 anchor rather than the fully copy-paste-ready score-5 anchor or the pseudocode-level score-3 anchor. | 4 / 5 |
Workflow Clarity | Six clearly sequenced steps (establish authority → deep pane diagnosis → classify → bounded recovery → verify → incident bundle/authorization) with explicit validation checkpoints: step 5 re-runs the smallest relevant checks and re-captures the pane, gates require stopping when blocked, and destructive actions (restart, clear, resubmit, issue submission) each have explicit preconditions. This matches the score-5 anchor (clear sequence, explicit validation, feedback loops, checklists). | 5 / 5 |
Progressive Disclosure | The skill is a self-contained SKILL.md (no references/, scripts/, or assets/ exist, so no references are broken) with well-organized sections (Scope, Workflow with six numbered subsections, Red Lines). At 194 lines, the pane-state taxonomy and the classification output format are inline material that could plausibly live in a one-level-deep reference file, which fits the score-4 anchor (good structure, most content appropriately placed, minor organization gaps) rather than the ideal split of the score-5 anchor. | 4 / 5 |
Total | 17 / 20 Passed |