CtrlK
BlogDocsLog inGet started
Tessl Logo

ccb-self-diagnose

Diagnose CCB runtime, mounted daemon graph, tmux namespace and panes, provider context, queue/inbox/trace, replies/artifacts, config drift, and storage boundaries. Use when the user asks what is broken, which agent is stuck, whether CCB is mounted, why a reply did not arrive, or what to check first.

74

Quality

91%

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

SKILL.md
Quality
Evals
Security

Quality

Content

96%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.

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.

DimensionReasoningScore

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

Description

87%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.

A strong description that explicitly states both capability and trigger conditions with concrete, user-natural trigger phrases and a clearly distinct niche. The only weaknesses are single-verb action phrasing and missing common synonyms such as 'debug' or 'troubleshoot' in the trigger terms.

Suggestions

Add common trigger synonyms such as 'debug', 'troubleshoot', or 'hung/not responding' alongside the existing 'what is broken' and 'stuck' phrases.

Vary the action verbs beyond the single 'Diagnose' (e.g., 'inspect panes, trace replies, check config drift') to sharpen the capability list.

DimensionReasoningScore

Specificity

"Diagnose CCB runtime, mounted daemon graph, tmux namespace and panes, provider context, queue/inbox/trace, replies/artifacts, config drift, and storage boundaries" comprehensively enumerates concrete diagnostic targets, but a single verb ('Diagnose') carries all of them rather than listing multiple distinct actions. It sits between anchor 4 (several specific actions, minor gaps) and anchor 5 (multiple distinct concrete actions), closer to comprehensive coverage than to a gap, but the action variety of the anchor-5 example is not matched.

4 / 5

Completeness

The description explicitly answers both: what ("Diagnose CCB runtime, mounted daemon graph, ... storage boundaries") and when ("Use when the user asks what is broken, which agent is stuck, ..."), mirroring the anchor-5 example's what-plus-concrete-trigger-phrase structure. It is not anchor 4 because the 'when' clause is fully explicit with multiple concrete trigger scenarios rather than only partly specific.

5 / 5

Trigger Term Quality

"what is broken, which agent is stuck, whether CCB is mounted, why a reply did not arrive, or what to check first" are natural phrases a user would actually say. However, common synonyms and phrasings like 'debug', 'troubleshoot', 'hung', or 'not responding' are absent, so coverage is good rather than comprehensive per the anchor-5 standard.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (CCB runtime diagnostics) with triggers ('whether CCB is mounted', 'why a reply did not arrive') that only apply to this skill, matching the anchor-5 clear-niche pattern. Other skills are unlikely to fire on these CCB-specific triggers.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

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.