CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

error-debugging-error-analysis

Analyze errors in distributed systems by debugging production incidents, tracing root causes, and implementing observability that surfaces failures early. Use when investigating errors or production incidents.

Quality

69%

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/error-debugging-error-analysis/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

38%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 skill has a sensible section layout and a logical high-level workflow, but it provides almost no concrete, executable guidance — every instruction is an abstract directive — and its only depth mechanism is a reference to a playbook file that does not exist in the bundle. The result is a thin overview that promises detail it cannot deliver, with notable padding (persona, Context, use-cases duplicating the description).

Suggestions

Add concrete, executable guidance to the Instructions section — e.g., specific log-search commands, tracing queries, or a worked example of narrowing an error from a stack trace — instead of abstract directives like 'Reproduce or narrow the issue with targeted experiments'.

Fix the broken reference: 'resources/implementation-playbook.md' is cited twice but no such file (or resources/ directory) exists in the bundle; create the playbook with the promised frameworks and checklists (conventionally under references/) or remove the reference.

Add explicit validation checkpoints and a feedback loop — e.g., what evidence confirms a root cause, and what to do when the issue cannot be reproduced — plus trim the persona line, Context paragraph, and 'Use this skill when' section that duplicate the frontmatter description.

DimensionReasoningScore

Conciseness

The core Instructions bullets are lean, but the body carries several padded sections: the persona line 'You are an expert error analysis specialist with deep expertise in...', the Context paragraph describing scope/goals ('using industry-standard observability tools, structured logging, distributed tracing...'), filler like 'Adapt your approach based on the provided context', and a 'Use this skill when' section that duplicates the frontmatter description. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than 4, where padding would be minor; it avoids 2 because no concepts Claude already knows are explained.

3 / 5

Actionability

The instructions are high-level imperatives with no concrete commands, tools, or examples: 'Gather error context, timestamps, and affected services', 'Reproduce or narrow the issue with targeted experiments', 'Identify root cause and validate with evidence'. The promised detailed playbook ('If detailed playbooks are required, open resources/implementation-playbook.md') does not exist in the bundle, so no executable specifics are ever delivered. This matches 'minimal concrete guidance; high-level hints but missing the specific steps' — it scores above 1 only because it instructs an ordered procedure rather than merely describing one.

2 / 5

Workflow Clarity

A coherent four-step sequence is present (gather context, reproduce/narrow, identify root cause, propose fixes), and 'Identify root cause and validate with evidence' names a checkpoint, matching 'steps listed but validation gaps'. It is not 4 because the validation is never operationalized — no explicit criteria for what counts as evidence and no feedback loop for error recovery (e.g., what to do when the issue cannot be reproduced); it is not 2 because the sequence is ordered and free of large gaps.

3 / 5

Progressive Disclosure

The body clearly signals a single one-level-deep reference ('resources/implementation-playbook.md for detailed analysis frameworks and checklists'), but the actual bundle contains no files at all — no resources/, references/, scripts/, or assets/ directories exist — so the only reference is dangling and the promised detailed content is inaccessible. Per the guideline to score against the actual bundle structure, this is 'minimal structure' at the bundle level; it is not 1 because SKILL.md itself is well-sectioned and navigable, and not 3 because a clearly signaled reference to a nonexistent file delivers no working progressive disclosure.

2 / 5

Total

10

/

20

Passed

Description

83%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 strong: it states concrete capabilities in third person and closes with an explicit 'Use when investigating errors or production incidents' trigger clause, cleanly answering both what and when. Minor room remains in keyword coverage (missing troubleshooting, logs, stack traces) and in mentioning remediation alongside analysis.

DimensionReasoningScore

Specificity

It names the domain ('errors in distributed systems') and several concrete actions — 'debugging production incidents', 'tracing root causes', 'implementing observability that surfaces failures early' — matching 'lists several specific actions; minor gaps in coverage'. It is not 5 because 'observability that surfaces failures early' is somewhat abstract and remediation is absent (the skill is titled 'Error Analysis and Resolution' but the description never mentions fixing or resolving); not 3 because it lists three concrete actions, more than 1-2.

4 / 5

Completeness

It explicitly answers both questions: what — 'Analyze errors in distributed systems by debugging production incidents, tracing root causes, and implementing observability' — and when — 'Use when investigating errors or production incidents', an explicit trigger clause with concrete trigger phrases. This matches the anchor 5 example structure; it exceeds 4 because the 'when' is explicit and specific rather than vague or merely implied.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'errors', 'debugging', 'production incidents', 'root causes', 'investigating errors' — phrases users would plausibly say. It is not 5 because common variations are missing ('troubleshooting', 'logs', 'stack traces', 'crashes', 'exceptions', 'outage'); not 3 because it goes well beyond 'some relevant keywords' with multiple natural phrasings.

4 / 5

Distinctiveness Conflict Risk

The framing around 'distributed systems', 'production incidents', 'root causes', and 'observability' carves a mostly distinct niche with minor overlap risk against general debugging/troubleshooting skills, matching 'mostly distinct; minor overlap risk with closely related skills'. It is not 5 because 'Use when investigating errors' is a fairly broad trigger that could fire for ordinary debugging requests; not 3 because the production-incident/distributed-systems scope gives it a clear, recognizable identity.

4 / 5

Total

17

/

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

rmyndharis/antigravity-skills

Path

skills/error-debugging-error-analysis/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.