CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fastapi-expert

Use when building high-performance async Python APIs with FastAPI and Pydantic V2. Invoke to create REST endpoints, define Pydantic models, implement authentication flows, set up async SQLAlchemy database operations, add JWT authentication, build WebSocket endpoints, or generate OpenAPI documentation. Trigger terms: FastAPI, Pydantic, async Python, Python API, REST API Python, SQLAlchemy async, JWT authentication, OpenAPI, Swagger Python.

74

Quality

93%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 content is a strong skill body: executable, modern code examples covering the main use cases, a checkpointed workflow, and a well-structured reference table pointing to six real, one-level-deep reference files. Improvements are minor — trim redundant sections and make the error-recovery loop explicit.

Suggestions

Remove the 'When to Use This Skill' bullet list (it duplicates the frontmatter description) and the 'Knowledge Reference' keyword paragraph, keeping only the attribution line, to tighten token efficiency.

In the Core Workflow checkpoint, add an explicit feedback loop, e.g. 'If a checkpoint fails: fix the code or schema, re-run pytest, and re-check /docs before proceeding to the next step.'

DimensionReasoningScore

Conciseness

The body is dominated by concrete, executable code that earns its tokens, but sections like 'When to Use This Skill' (duplicating the description), the bare 'Knowledge Reference' keyword list, and the attribution/footer are unnecessary padding that could be trimmed. This fits 'efficient; minor instances of over-explanation that could be trimmed' rather than score 5's 'every token earns its place'.

4 / 5

Actionability

Four copy-paste-ready files (schemas.py, routers/users.py, crud.py, security.py) use modern idiomatic patterns (Annotated dependencies, Pydantic V2 model_config/field_validator, 'X | None') and cover the common case of schema + endpoint + CRUD + JWT auth end-to-end, matching 'fully executable; copy-paste ready code; specific examples cover the common cases'. Score 4 would require minor gaps, but the only unshown pieces (app.database.get_db, app.models.User) are standard scaffolding, not gaps.

5 / 5

Workflow Clarity

The Core Workflow gives a clear 5-step sequence with an explicit checkpoint ('confirm schemas validate correctly, endpoints return expected HTTP status codes, and /docs reflects the intended API surface before proceeding') and a concrete test command ('run pytest after each endpoint group'). It falls short of score 5 because the error-recovery feedback loop (what to do when a checkpoint fails: fix and re-run) is implied rather than explicit.

4 / 5

Progressive Disclosure

The body is a concise overview with a 'Reference Guide' table giving Topic, Reference path, and 'Load When' conditions; all six cited references/*.md files exist and are one level deep, matching 'clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'. It does not fit score 4's 'minor organization gaps'.

5 / 5

Total

18

/

20

Passed

Description

96%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 near-exemplary: it explicitly states what the skill does and when to use it, lists seven concrete capabilities, and provides comprehensive natural trigger terms with synonyms. The only weakness is a couple of broad trigger terms ('Python API', 'async Python') that slightly raise conflict risk with other Python backend skills.

DimensionReasoningScore

Specificity

Lists seven concrete actions ('create REST endpoints, define Pydantic models, implement authentication flows, set up async SQLAlchemy database operations, add JWT authentication, build WebSocket endpoints, or generate OpenAPI documentation') with comprehensive coverage of the domain, matching the anchor for multiple specific concrete actions rather than the score-4 anchor's 'minor gaps in coverage'.

5 / 5

Completeness

'Use when building high-performance async Python APIs with FastAPI and Pydantic V2. Invoke to create REST endpoints...' explicitly answers both what (concrete actions) and when (use-when clause plus trigger terms), matching the score-5 anchor; score 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Trigger terms 'FastAPI, Pydantic, async Python, Python API, REST API Python, SQLAlchemy async, JWT authentication, OpenAPI, Swagger Python' comprehensively cover the natural vocabulary users would say, including synonyms (OpenAPI/Swagger, FastAPI/Pydantic). It clearly fits the comprehensive-coverage anchor rather than score 4's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

The FastAPI/Pydantic V2 niche is clear with distinct framework-specific triggers, but broad terms like 'Python API' and 'async Python' create minor overlap risk with closely related Python API skills (e.g., django-expert), fitting 'mostly distinct; minor overlap risk' rather than score 5's 'minimal conflict risk'.

4 / 5

Total

19

/

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

Jeffallan/claude-skills

Path

skills/fastapi-expert/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.