CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

error-debugging-error-analysis

You are an expert error analysis specialist with deep expertise in debugging distributed systems, analyzing production incidents, and implementing comprehensive observability solutions.

37

Quality

47%

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 ./plugins/AI-Agents-Safe-Coding-Skills/skills/error-debugging-error-analysis/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

31%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 has a sensible section skeleton (use-when / do-not-use / instructions / safety), but the content is thin: generic debugging guidance Claude already knows, a padded Context paragraph, no concrete commands or examples, and a dangling reference to a playbook file that is missing from the bundle.

Suggestions

Fix or remove the dangling reference: either include resources/implementation-playbook.md in the bundle or drop the two mentions from Instructions and Resources.

Add concrete, executable guidance to the Instructions — e.g., specific commands for correlating timestamps across service logs, trace queries, or a worked root-cause analysis example — instead of generic directional bullets.

Delete the verbatim persona opener and compress the Context paragraph to one or two lines of scope statement, letting the Instructions carry the content.

DimensionReasoningScore

Conciseness

The opening line repeats the frontmatter description verbatim, and the Context paragraph ('This tool provides systematic error analysis and resolution capabilities for modern applications... using industry-standard observability tools, structured logging, distributed tracing, and advanced debugging techniques') is padded marketing-style filler describing what the skill is rather than instructing — matching anchor 2's 'several unnecessary explanations or padded sections'. It is above anchor 1 because the Instructions, Safety, and use-when sections are reasonably tight.

2 / 5

Actionability

The Instructions are high-level directional hints ('Gather error context', 'Reproduce or narrow the issue with targeted experiments', 'Propose fixes, tests, and preventive measures') with no concrete commands, tools, log/trace-analysis techniques, or worked examples — matching anchor 2 ('minimal concrete guidance; high-level hints but missing the specific steps to execute'). Not anchor 3, since there is no partially-executable detail like code or specific commands to fill in.

2 / 5

Workflow Clarity

The Instructions give a recognizable sequence (gather context → reproduce/narrow → identify root cause → propose fixes) and the Safety section adds an approval/rollback checkpoint, so it is above anchor 2. But validation checkpoints are implicit — 'validate with evidence' and 'tests' are mentioned in passing without any verify-fix-retry loop — matching anchor 3 ('steps listed but validation gaps; checkpoints missing or implicit').

3 / 5

Progressive Disclosure

The body is short with clear section headers, but it twice points to 'resources/implementation-playbook.md' ('If detailed playbooks are required, open...' and the Resources section) and that file does not exist in the bundle — there are no references/, scripts/, assets/, or resources/ directories. A clearly-signaled reference that leads nowhere is a broken navigation pointer, which drags the score to anchor 2 territory despite the otherwise decent section organization.

2 / 5

Total

9

/

20

Passed

Description

40%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 a second-person persona statement rather than a capability-plus-trigger description. It names a relevant domain but provides no 'Use when' guidance, no concrete actions, and no distinguishing trigger phrases, making it hard for a user (or Claude) to know when to invoke it.

Suggestions

Rewrite in third person as a capability statement, e.g. 'Analyzes errors and production incidents: gathers diagnostics, performs root-cause analysis across distributed services, and designs observability and error-handling improvements.'

Add an explicit trigger clause: 'Use when investigating production incidents, recurring errors, stack traces, or root-cause analysis across services, or when designing observability improvements.'

Include natural user phrasings and synonyms such as 'troubleshooting', 'debugging', 'incident', 'stack trace', and 'logs' to improve both trigger quality and distinctiveness.

DimensionReasoningScore

Specificity

The description names the domain ('debugging distributed systems, analyzing production incidents, and implementing comprehensive observability solutions') but the actions are minimal/generic persona claims rather than concrete capabilities — anchor 2 — and the second-person voice ('You are an expert...') triggers the mandated 1-point specificity reduction, yielding 1. It does not fit anchor 1's 'pure abstract language' on its own merits, but the explicit voice penalty applies.

1 / 5

Completeness

The 'what' is moderately conveyed (analyze errors, debug distributed systems, implement observability), but there is no 'Use when...' clause or equivalent trigger guidance anywhere, so completeness is capped at 3 per the judging guidelines. It is above anchor 2 because the 'what' is clearer than 'vague', but below anchor 4 because the 'when' is entirely absent rather than just imprecise.

3 / 5

Trigger Term Quality

Phrases like 'error analysis', 'debugging distributed systems', 'production incidents', and 'observability' are natural terms users would say, but common variations are missing ('root cause', 'troubleshooting', 'stack traces', 'logs', 'incident response'). This matches anchor 3 ('some relevant keywords but missing common variations or synonyms') and falls short of anchor 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

'Error analysis specialist' and 'observability' carve out a somewhat specific niche, but the broad debugging/incident framing would overlap with general debugging, code-review, and incident-response skills. Matches anchor 3 ('somewhat specific but could still overlap with similar skills'); not anchor 4 since no concrete distinct triggers are given.

3 / 5

Total

10

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/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.