CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl-labs/fastapi-error-handling

Production error handling for FastAPI — exception handlers, structured error

96

6.12x
Quality

96%

Does it follow best practices?

Impact

98%

6.12x

Average score across 5 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that hits all the marks. It provides specific capabilities, includes natural trigger terms developers would use, explicitly states both what it does and when to use it, and carves out a distinct niche (FastAPI error handling) that minimizes conflict with other skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'exception handlers, structured error responses, async error patterns, and graceful shutdown' - these are distinct, actionable capabilities.

3 / 3

Completeness

Clearly answers both what ('exception handlers, structured error responses, async error patterns, graceful shutdown') AND when ('Use when building or reviewing FastAPI backends, when you see unhandled exceptions returning raw 500s, or when error response formats are inconsistent').

3 / 3

Trigger Term Quality

Includes natural keywords users would say: 'FastAPI', 'exception handlers', 'error responses', 'unhandled exceptions', '500s', 'error response formats' - good coverage of terms developers naturally use when facing these issues.

3 / 3

Distinctiveness Conflict Risk

Highly specific niche: FastAPI + production error handling. The combination of framework-specific focus and error handling domain creates clear boundaries unlikely to conflict with general Python skills or other web framework skills.

3 / 3

Total

12

/

12

Passed

Implementation

92%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a high-quality skill that provides concrete, executable guidance for FastAPI error handling. The content is well-organized with clear problem statement, actionable code examples, and verification checklists. Minor improvement could come from better progressive disclosure by moving some detailed content to reference files.

Suggestions

Consider moving the detailed 'Error Response Format' examples and 'Applying to Existing Code' sections to a separate REFERENCE.md file, keeping SKILL.md focused on the quick start implementation

DimensionReasoningScore

Conciseness

The content is lean and efficient, avoiding explanations of concepts Claude already knows (like what FastAPI is or how exceptions work). Every section provides actionable information without padding.

3 / 3

Actionability

Provides fully executable, copy-paste ready code for error classes, exception handlers, route usage, and shutdown handling. Includes complete imports and realistic examples.

3 / 3

Workflow Clarity

Clear 4-step sequence for adding error handling to an existing app, with explicit 'Why all three?' explanation serving as validation rationale. The 'Applying to Existing Code' section provides a clear checklist for retrofitting, and the final checklist serves as verification.

3 / 3

Progressive Disclosure

Content is well-structured with clear sections, but the skill is somewhat long (~150 lines) and could benefit from splitting the detailed handler explanations or the 'Applying to Existing Code' section into separate reference files. The verifiers section at the end references external files appropriately.

2 / 3

Total

11

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Reviewed

Table of Contents