python-fastapi-patterns
FastAPI web framework patterns. Triggers on: fastapi, api endpoint, dependency injection, pydantic model, openapi, swagger, starlette, async api, rest api, uvicorn.
81
75%
Does it follow best practices?
Impact
92%
1.53xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./data/skills-md/0xdarkmatter/claude-mods/python-fastapi-patterns/SKILL.mdQuality
Discovery
62%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 excels at trigger term coverage with a comprehensive list of FastAPI-related keywords, making it highly distinctive and easy to match. However, it critically lacks specificity about what the skill actually does — it names no concrete actions or capabilities. Adding explicit actions (e.g., 'create API endpoints, define Pydantic models, configure dependency injection, set up middleware') would significantly improve it.
Suggestions
Add specific concrete actions the skill performs, e.g., 'Creates API endpoints, defines Pydantic request/response models, configures dependency injection, sets up middleware and authentication.'
Reformat the trigger list into a 'Use when...' clause that provides contextual guidance, e.g., 'Use when building or modifying FastAPI applications, defining REST API endpoints, or working with Pydantic models for request validation.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description says 'FastAPI web framework patterns' which is vague and abstract. It does not list any concrete actions like 'create endpoints', 'define routes', 'configure middleware', or 'validate request bodies'. No specific capabilities are described. | 1 / 3 |
Completeness | The 'when' is addressed through the explicit 'Triggers on:' list, but the 'what' is extremely weak — 'FastAPI web framework patterns' doesn't explain what the skill actually does. It lacks a 'Use when...' clause with contextual guidance, though the trigger list partially compensates. | 2 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'fastapi', 'api endpoint', 'dependency injection', 'pydantic model', 'openapi', 'swagger', 'starlette', 'async api', 'rest api', 'uvicorn'. These are terms users would naturally use when working with FastAPI. | 3 / 3 |
Distinctiveness Conflict Risk | The trigger terms are highly specific to the FastAPI ecosystem (fastapi, starlette, uvicorn, pydantic model) and unlikely to conflict with other skills. This creates a clear niche that is well-differentiated. | 3 / 3 |
Total | 9 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong reference-style skill that efficiently covers FastAPI's core patterns with executable, well-structured code examples. The progressive disclosure is excellent, with inline essentials and clear pointers to advanced references. The only weakness is the lack of a sequenced workflow or validation checkpoints for building/scaffolding an API, though this is partially mitigated by the pattern-reference nature of the skill.
Suggestions
Consider adding a brief 'Getting Started' workflow sequence (e.g., 1. scaffold with script, 2. define models, 3. add routes, 4. test with TestClient) to improve workflow clarity for users building a new API from scratch.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. Every section provides executable code without explaining what FastAPI, Pydantic, or dependency injection are. No unnecessary preamble or concept explanations—it trusts Claude's existing knowledge and focuses on patterns. | 3 / 3 |
Actionability | All code examples are concrete, executable Python with proper imports, type annotations, and realistic patterns. The examples cover the full spectrum from basic app setup to dependency injection, exception handling, and router organization—all copy-paste ready. | 3 / 3 |
Workflow Clarity | The skill presents patterns as independent sections rather than a sequenced workflow, which is appropriate for a reference-style skill. However, there's no guidance on the order of building an API (e.g., models first, then routes, then DI), and no validation/testing checkpoints are mentioned despite the scaffold script being referenced. | 2 / 3 |
Progressive Disclosure | Excellent structure with a concise overview of core patterns inline, then clear one-level-deep references to advanced topics (dependency injection, middleware, validation, background tasks). The quick reference table, scripts, assets, and see-also sections are well-organized for navigation. | 3 / 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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
- Repository
- NeverSight/skills_feed
- Commit
9f4534c
- 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.