CtrlK
BlogDocsLog inGet started
Tessl Logo

ccb-diagnose

Diagnose a named CCB agent by combining authoritative runtime and job lineage with deep read-only pane inspection, apply bounded recovery when evidence supports it, verify the result, and request authorization before submitting a redacted GitHub issue. Use for `$ccb_diagnose agentname`, `$ccb-diagnose agentname`, or reports that a CCB agent is stuck, disconnected, not continuing, not replying, or showing provider errors.

72

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is ccb-diagnose in SeemSeam/claude_codex_bridge

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is exemplary: it states a multi-step capability pipeline in third person with concrete actions, and provides an explicit 'Use for' trigger clause covering both command aliases and the natural-language failure symptoms a user would report. Trigger coverage includes synonyms and variations, giving it both completeness and low conflict risk.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions with comprehensive coverage: 'Diagnose a named CCB agent', 'combining authoritative runtime and job lineage with deep read-only pane inspection', 'apply bounded recovery when evidence supports it', 'verify the result', and 'request authorization before submitting a redacted GitHub issue'. This matches the score-5 anchor (multiple specific concrete actions, comprehensive) and is not the level below, which expects only 'several specific actions; minor gaps'.

5 / 5

Completeness

Explicitly answers both questions: the 'what' is the full diagnose → recover → verify → authorized-issue-submission pipeline, and the 'when' is an explicit 'Use for ...' clause with concrete trigger phrases. This matches the score-5 anchor exactly; the score-4 anchor would require the 'when' to be less explicit or specific.

5 / 5

Trigger Term Quality

Triggers cover both explicit invocation aliases ('$ccb_diagnose agentname', '$ccb-diagnose agentname') and the natural failure phrases a user would actually say: 'stuck, disconnected, not continuing, not replying, or showing provider errors'. This is comprehensive coverage including synonyms, matching the score-5 anchor rather than the score-4 anchor, which expects 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

'CCB agent' names a clear niche with distinct triggers (CCB-specific invocations and CCB-agent failure symptoms), so there is minimal conflict risk with generic maintenance or debugging skills. It matches the score-5 anchor ('clear niche with distinct triggers') and is clearly above the score-4 anchor ('minor overlap risk with closely related skills').

5 / 5

Total

20

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
SeemSeam/claude_codex_bridge
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.