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.

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Failed to scan

The risk profile of this skill

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 body is highly actionable with current, executable code and a clean reference structure pointing to verified bundle files. Its main weakness is mild redundancy (repeated trigger terms, a restated knowledge list) and a missing explicit validate->fix->retry loop in the workflow.

Suggestions

Add an explicit error-recovery loop to the Core Workflow checkpoint (e.g., 'if pytest or /docs differs from intended surface, fix and re-run before proceeding') to push workflow clarity toward 5.

Remove the duplicated trigger-term list in the metadata/footers and the terminal Knowledge Reference line that restates the reference table to tighten conciseness.

Replace the `SECRET_KEY = "read-from-env"` placeholder comment with a one-line `os.environ`/settings reference to keep the security snippet fully production-ready.

Dimension	Reasoning	Score
Conciseness	Lean with no concept tutorials and executable inline code, but the trigger-terms list is duplicated across description/metadata and the closing Knowledge Reference partly restates the reference table; minor trims possible.	4 / 5
Actionability	Provides copy-paste-ready, executable examples for schemas, routing, CRUD, and JWT security using current Pydantic V2, async SQLAlchemy, and Annotated DI patterns covering common cases.	5 / 5
Workflow Clarity	A clear 5-step numbered Core Workflow with an explicit post-step checkpoint and a 'run pytest after each endpoint group' feedback loop; capped just below 5 because there is no explicit error-recovery loop for failed validation.	4 / 5
Progressive Disclosure	Clear overview with a well-signaled one-level-deep reference table (topic, file, load condition); all six referenced files verified to exist, with no nested indirection.	5 / 5
	Total	18 / 20 Passed

Description

100%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 excellent: it states concrete capabilities, explicit invocation triggers, and a comprehensive trigger-term list in third-person voice. It answers both what the skill does and when to use it with minimal conflict risk.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions (create REST endpoints, define Pydantic models, implement authentication flows, set up async SQLAlchemy operations, add JWT authentication, build WebSocket endpoints, generate OpenAPI documentation) for comprehensive coverage.	5 / 5
Completeness	Clearly answers 'what' via the enumerated action list and 'when' via 'Use when building high-performance async Python APIs...' and 'Invoke to create...' with concrete trigger phrases.	5 / 5
Trigger Term Quality	An explicit trigger-terms block covers natural phrases and synonyms users would say (FastAPI, Pydantic, async Python, Python API, JWT authentication, OpenAPI, Swagger Python).	5 / 5
Distinctiveness Conflict Risk	Narrow, well-defined niche (FastAPI + Pydantic V2 + async SQLAlchemy) with distinct triggers and minimal overlap risk against generic backend or Django skills.	5 / 5
	Total	20 / 20 Passed

Validation

100%

Warnings & errors only

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
Commit: 882ef55

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.