CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

common-error-handling

Cross-cutting standards for error design, response shapes, error codes, and boundary placement across API, domain, and infrastructure layers. Use when defining error hierarchies, wrapping exceptions, building standardized error responses, or placing error boundaries in layered architectures.

60

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 ./.agents/skills/common/common-error-handling/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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 lean and well-sectioned with genuinely concrete mechanics (wrap/replace/error-code rules, inline snippet examples), but it is undermined by a dangling colon where the standard envelope should be, a tri-stated swallow-errors rule, a meaningless P1 heading, and two overlapping reference files that disagree on the envelope shape. These are easy structural fixes that would lift actionability and conciseness substantially.

Suggestions

Fix the dangling 'Standard Shape: APIs must return standardized JSON envelope:' line — either show the envelope JSON inline or make the sentence a complete pointer ('See [implementation examples](references/implementation.md) for the standard envelope').

State the swallow-errors rule once (in Anti-Patterns or the checklist) and delete the other two duplications, removing the '## **Priority: P1 (HIGH)**' noise heading at the same time.

Consolidate references/implementation.md and references/api-error-contract.md into a single file with one canonical envelope shape (resolve whether 'details[]' is part of it) and keep one clearly-signaled link per topic.

DimensionReasoningScore

Conciseness

The same swallow-errors rule is stated three times ('Never `catch(e) {}` without logging or re-throwing', 'an empty catch must become an explicit log, handling branch, returned error, or rethrow', 'Never swallow errors: do not use an empty `catch`'), and a noise heading '## **Priority: P1 (HIGH)**' adds no guidance. Beyond 'minor trimming' (anchor 4), though the body is otherwise lean with no padding of known concepts.

3 / 5

Actionability

Some concrete guidance exists ('fmt.Errorf("process: %w", err)', "new Error('msg', { cause })", 'SCREAMING_SNAKE_CASE IDs (ORDER_PAYMENT_FAILED)', 'Use `400` with specific details'), but the core deliverable is broken: '**Standard Shape**: APIs must return standardized JSON envelope:' ends in a dangling colon with no shape shown inline, so a key detail is missing.

3 / 5

Workflow Clarity

A standards skill organized by layer with clear boundary rules ('API Layer: Map domain errors to HTTP responses globally', 'Domain Layer: Throw pure business errors', 'Infra Layer: Wrap 3rd-party exceptions') and a closing checklist. Not 5 because the dangling colon and the P1 heading noise introduce minor incoherence in an otherwise simple, single-purpose skill.

4 / 5

Progressive Disclosure

Both referenced files ([implementation examples](references/implementation.md), [API Error Contract](references/api-error-contract.md)) are real and one level deep, with a dedicated References section. Not 5 because the two files are largely redundant (both show the envelope) and describe slightly different shapes ('code/message/traceId' vs 'code/message/traceId/details').

4 / 5

Total

14

/

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.

A strong description that explicitly states both what the skill covers and when to use it, with concrete trigger phrases and a clear layered-architecture framing. Its only weaknesses are mild: the first sentence enumerates topics rather than actions, and a few natural trigger variations (e.g. try/catch) are missing.

DimensionReasoningScore

Specificity

Names several concrete capability areas ('error design, response shapes, error codes, and boundary placement across API, domain, and infrastructure layers') plus concrete actions in the use-when clause ('defining error hierarchies, wrapping exceptions, building standardized error responses'). Not 5 because the opening sentence describes topical coverage rather than enumerating multiple concrete actions.

4 / 5

Completeness

Clearly answers both: 'what' ('Cross-cutting standards for error design, response shapes, error codes, and boundary placement...') and an explicit 'when' with concrete trigger phrases ('Use when defining error hierarchies, wrapping exceptions, building standardized error responses, or placing error boundaries in layered architectures').

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'defining error hierarchies', 'wrapping exceptions', 'building standardized error responses', 'placing error boundaries', 'error codes'. Not 5 because common variations users say ('try/catch', 'catch', language-specific exception terms) are absent.

4 / 5

Distinctiveness Conflict Risk

The layer-boundary and error-code framing carves a mostly distinct niche, but 'wrapping exceptions' and generic error-handling phrasing could overlap with language-specific error-handling or logging skills. Minor overlap risk, above anchor 3.

4 / 5

Total

17

/

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

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

HoangNguyen0403/agent-skills-standard

Path

.agents/skills/common/common-error-handling/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.