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.
97
100%
Does it follow best practices?
Impact
94%
1.14xAverage score across 6 eval scenarios
Passed
No known issues
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 exemplary skill description that excels across all dimensions. It opens with a clear 'Use when' clause, provides comprehensive specific actions, and includes an explicit list of trigger terms that match natural developer language. The focus on FastAPI/Pydantic V2 creates a distinct niche that minimizes conflict risk with other Python or API-related skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'create REST endpoints, define Pydantic models, implement authentication flows, set up async SQLAlchemy database operations, add JWT authentication, build WebSocket endpoints, generate OpenAPI documentation.' | 3 / 3 |
Completeness | Clearly answers both what (building async Python APIs with specific capabilities) and when ('Use when building high-performance async Python APIs') with explicit trigger guidance via the 'Invoke to...' clause and listed trigger terms. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say, explicitly listed: 'FastAPI, Pydantic, async Python, Python API, REST API Python, SQLAlchemy async, JWT authentication, OpenAPI, Swagger Python' - these match how developers naturally describe these tasks. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche targeting FastAPI/Pydantic V2 specifically, with distinct triggers like 'FastAPI', 'Pydantic', 'async SQLAlchemy' that are unlikely to conflict with generic Python or other web framework skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an exemplary skill file that demonstrates best practices across all dimensions. It provides concrete, executable code examples while maintaining excellent token efficiency, includes clear workflow checkpoints with validation steps, and uses progressive disclosure effectively through a well-organized reference table. The constraints section with MUST DO/MUST NOT DO lists adds valuable guardrails.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, assuming Claude's competence with Python and web development. No unnecessary explanations of basic concepts; every section provides actionable, specific guidance without padding. | 3 / 3 |
Actionability | Provides fully executable, copy-paste ready code examples including complete schema definitions, router implementations, CRUD operations, and JWT authentication. All code is concrete Python, not pseudocode. | 3 / 3 |
Workflow Clarity | Clear 5-step workflow with explicit checkpoint instruction after each step. Includes validation guidance (run pytest, verify OpenAPI docs, confirm schemas validate) and specifies when to proceed to next steps. | 3 / 3 |
Progressive Disclosure | Excellent structure with quick-start content inline and a clear reference table pointing to one-level-deep detailed guides. Topics are well-organized with clear 'Load When' guidance for each reference file. | 3 / 3 |
Total | 12 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- jeffallan/claude-skills
- Commit
5b76101
- 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.