CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

handling-api-errors

Implement standardized error handling with proper HTTP status codes and error responses. Use when implementing standardized error handling. Trigger with phrases like "add error handling", "standardize errors", or "implement error responses".

Quality

78%

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/api-development/api-error-handler/skills/handling-api-errors/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 a well-structured, actionably dense overview: concrete error-class and envelope specs, a useful troubleshooting table, correctly ordered steps ending in test verification, and clean one-level-deep reference files. The only real weaknesses are minor — a slightly redundant Overview/Resources section and the absence of executable code in the main file (deferred to the implementation reference).

DimensionReasoningScore

Conciseness

The body is dense and instructional — typed error classes with exact status codes ("ValidationError (400) ... RateLimitError (429)"), an RFC 7807 field list, and a tight error-cause-solution table — with little explanation of concepts Claude already knows. Minor trimmable padding exists: the Overview paragraph restates the Instructions, and two Resources bullets ("Express error handling best practices", "HTTP status code decision tree for API responses") carry no URLs or specifics. Anchor 4 ("Efficient; minor instances of over-explanation that could be trimmed") fits better than 3 because no section is genuinely padded.

4 / 5

Actionability

Guidance is concrete and executable: exact envelope fields ("type, title, status, detail, instance"), validation error shape ("field, message, code properties"), an example RFC 7807 JSON body, a one-line Express middleware signature ("app.use((err, req, res, next) => {...})"), and a defined output file layout. It is not a 5 because no complete copy-paste code exists in the body itself — implementation details are delegated to references/implementation.md, leaving minor gaps in the main file.

4 / 5

Workflow Clarity

The 9-step Instructions sequence is coherent and correctly ordered (audit → envelope → typed classes → middleware → validation formatting → env config → monitoring → process-level handlers → tests), ending in a verification step ("Write tests verifying that each error type produces the correct HTTP status code"). Anchor 4 fits rather than 5 because the validation step lacks a feedback loop — there is no explicit "if tests fail, fix and re-run" guidance — and the destructive/batch cap does not apply since the skill is additive.

4 / 5

Progressive Disclosure

The body is a clear, well-sectioned overview (~66 lines) with three well-signaled, one-level-deep references that all exist in the bundle: "See references/implementation.md for the full implementation guide", "Refer to references/errors.md for comprehensive error patterns", and "See references/examples.md for additional examples". Each reference is placed at the end of its relevant section, no content that belongs in a separate file is inlined, and none of the reference files nest further references. This matches anchor 5 exactly.

5 / 5

Total

17

/

20

Passed

Description

70%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 answers both what and when with natural trigger phrases, but the what-clause is thin: it summarizes only the generic shape of the work (standardized handling, status codes) without surfacing the skill's concrete capabilities. Distinctiveness is good with only minor overlap risk against general API/debugging skills.

Suggestions

Enumerate the concrete capabilities in the what-clause, e.g. "Implement standardized API error handling with RFC 7807 Problem Details responses, typed error classes, and centralized error middleware".

Add commonly used trigger synonyms such as "exception handling", "API errors", or "return proper status codes" to the trigger phrase list.

Make the "Use when" clause describe user scenarios rather than restate the what, e.g. "Use when building or hardening API error responses".

DimensionReasoningScore

Specificity

The description names the domain and 1-2 concrete actions — "Implement standardized error handling with proper HTTP status codes and error responses" — but does not enumerate what the skill actually does (no mention of RFC 7807, typed error classes, centralized middleware, or error monitoring, which the body covers). It matches anchor 3 ("Names domain and 1-2 concrete actions, but not comprehensive") better than anchor 4 because the actions listed are generic rather than several specific ones.

3 / 5

Completeness

Both what ("Implement standardized error handling with proper HTTP status codes and error responses") and when ("Use when implementing standardized error handling") are present, plus explicit trigger phrases. However, the "Use when" clause is tautological — it restates the what rather than describing user scenarios — so the "when" could be more specific, matching anchor 4 rather than anchor 5's fully concrete trigger guidance.

4 / 5

Trigger Term Quality

Provides natural trigger phrases a user would actually say: "add error handling", "standardize errors", "implement error responses". This is good keyword coverage per anchor 4, though common synonyms like "exception handling", "API errors", or "status codes" are missing, which keeps it below anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"Standardized error handling" with HTTP status codes and error responses is a clear niche with distinct triggers, but it has minor overlap risk with closely related skills (general API-development, logging, or debugging skills that might also trigger on "error handling"). Anchor 4 ("Mostly distinct; minor overlap risk with closely related skills") is the best fit.

4 / 5

Total

15

/

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

allowed_tools_field

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

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

jeremylongshore/tons-of-skills-marketplace

Path

plugins/api-development/api-error-handler/skills/handling-api-errors/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.