CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

multi-ai-debugging

Systematic debugging using Claude, Gemini, and Codex as specialized agents. Multi-agent root cause analysis, log analysis, error classification, and auto-fix generation. Use when debugging production issues, analyzing error logs, performing root cause analysis, troubleshooting complex systems, or implementing self-healing patterns.

Quality

76%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/multi-ai-debugging/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is well structured and actionable, with concrete prompt templates, commands, and genuine verification loops (critic verdicts, reproduction tests). It is dragged down by verbosity — decision trees, severity matrices, and generic integration code that restate what Claude already knows — and by inlining detailed material that belongs in the existing reference files.

Suggestions

Move the error-type decision tree, severity assessment matrix, and P1-P4 definitions out of SKILL.md or delete them — they restate knowledge Claude already has and add substantial token cost without new information.

Replace the inline Operation 6 playbook code and the OpenTelemetry/log-correlation snippets with pointers to references/self-healing-playbooks.md and a new observability reference, keeping SKILL.md as an overview.

Trim the ~60-line example debugging session to a brief output-format sketch, and remove the 'Based on 2024-2025 best practices' and 'validated by tri-AI research' claims, which are unverifiable padding.

DimensionReasoningScore

Conciseness

Noticeably verbose across several padded sections: the error-type decision tree ('NullPointer/TypeError → Missing null check', 'Disk full → Resource exhaustion'), the P1–P4 severity definitions, the generic OpenTelemetry and log-correlation code, and a ~60-line worked example session are all concepts Claude already knows. Not 3 — these are several unnecessary explanations, not just occasional tightening; not 1 because the core prompt templates do add scaffolding value.

2 / 5

Actionability

Mostly executable guidance: concrete bash commands ('git log --oneline -20', 'gemini -p "..."', 'codex "Review this fix..."'), fill-in prompt templates, and a before/after code fix. Minor gaps — Python snippets call undefined helpers (analyze, query_logs, get_parent_spans, multi_agent_debug), so they are illustrative rather than executable. Anchor 4 fits; anchor 5 would require fully runnable code.

4 / 5

Workflow Clarity

Each operation has a clear sequence, and the risky ones include explicit validation checkpoints: RCA has a Cross-Verify step ('Design a reproduction test', 'Confidence assessment'), and auto-fix has a critic loop with 'Verdict: APPROVE / NEEDS_REVISION / REJECT' plus a regression-test step. Not 5 because Operations 1, 3, and 6 lack any verification checkpoint; not 3 because feedback loops are explicitly present where fixes are generated.

4 / 5

Progressive Disclosure

References are real and clearly signaled ('references/log-analysis-patterns.md', 'references/self-healing-playbooks.md'), but substantial content that belongs in those files is inlined: the self-healing playbook code in Operation 6 duplicates references/self-healing-playbooks.md, and the example session and observability integration could be separate references. Not 4 — a ~640-line body is more than an overview; not 2 because sections are well organized and references are not buried.

3 / 5

Total

13

/

20

Passed

Description

88%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: it states concrete capabilities, uses natural trigger phrases, and explicitly covers both what the skill does and when to use it. Its only weaknesses are a few missing common trigger variations (stack traces, incidents) and moderate overlap risk with generic debugging skills.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — 'Multi-agent root cause analysis, log analysis, error classification, and auto-fix generation' — giving comprehensive coverage of the skill's operations. Not below 4, since coverage is broad rather than having minor gaps; anchor 5's comprehensive multi-action example matches.

5 / 5

Completeness

Explicitly answers both: what ('Systematic debugging using Claude, Gemini, and Codex as specialized agents' plus enumerated capabilities) and when ('Use when debugging production issues, analyzing error logs, performing root cause analysis, troubleshooting complex systems, or implementing self-healing patterns') with concrete trigger phrases. Matches anchor 5 exactly.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'debugging production issues', 'analyzing error logs', 'performing root cause analysis', 'troubleshooting complex systems' are phrases users would naturally say. Not 5 because common variations like 'stack traces', 'incidents', 'post-mortem', or specific error symptoms (e.g. 500 errors, performance degradation) are missing; not 3 because coverage is clearly better than partial.

4 / 5

Distinctiveness Conflict Risk

The multi-AI ensemble framing ('using Claude, Gemini, and Codex as specialized agents') carves a distinct niche, but broad triggers like 'debugging production issues' and 'troubleshooting complex systems' overlap with generic debugging and troubleshooting skills. Mostly distinct with minor overlap risk — anchor 4; anchor 5 would require triggers unlikely to fire a plain debugging skill.

4 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (644 lines); consider splitting into references/ and linking

Warning

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

skills/multi-ai-debugging/SKILL.md

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.