FastAPI framework with Pydantic v2 patterns, PII sanitisation, and practical workflows
Skills
2
Reviewed
2/2
Average Score
94%
skills/scaffold-project/SKILL.md
Activation
85%
Implementation
100%
Validation
88%| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata' field is not a dictionary | Warning |
license_field | 'license' field is missing | Warning |
Total | 14 / 16 Passed | |
Implementation
100%This is an excellent skill that efficiently teaches Claude how to scaffold a FastAPI project. It provides a clear directory structure, executable code for all generated files, a logical step sequence, and includes verification. The content is lean, actionable, and well-organized.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line serves a purpose - directory structure is shown compactly, code examples are minimal but complete, and no unnecessary explanations of FastAPI concepts Claude already knows. | 3 / 3 |
Actionability | Provides fully executable, copy-paste ready code for all generated files, specific directory structure, and concrete verification commands. No pseudocode or vague instructions. | 3 / 3 |
Workflow Clarity | Clear 7-step sequence with explicit verification at the end. The workflow includes a concrete validation step (running the server and testing the health endpoint) to confirm success. | 3 / 3 |
Progressive Disclosure | For a focused scaffolding skill under 50 lines, the content is well-organized with clear sections (layout, steps, code blocks). No need for external references given the self-contained scope. | 3 / 3 |
Total | 12 / 12 Passed |
Activation
85%This is a well-crafted skill description that clearly communicates its purpose and includes explicit 'Use when' guidance. The main weakness is limited trigger term coverage - it could benefit from additional natural language variations users might employ when requesting this functionality.
Suggestions
Add trigger term variations like 'API project', 'backend', 'REST API', 'initialize', 'bootstrap', or 'setup FastAPI' to improve discoverability
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Scaffold a new FastAPI project', 'opinionated directory layout', 'pydantic-settings config', and 'starter files'. These are concrete, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('Scaffold a new FastAPI project with an opinionated directory layout, pydantic-settings config, and starter files') and when ('Use when creating a new FastAPI application from scratch') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes good terms like 'FastAPI', 'new', 'from scratch', and 'application', but misses common variations users might say like 'API project', 'backend', 'REST API', 'initialize', 'bootstrap', or 'setup'. | 2 / 3 |
Distinctiveness Conflict Risk | Very specific niche targeting FastAPI project scaffolding specifically. The combination of 'FastAPI', 'scaffold', 'new project', and 'from scratch' creates a distinct trigger profile unlikely to conflict with general Python or web development skills. | 3 / 3 |
Total | 11 / 12 Passed |
skills/run-check-server/SKILL.md
Activation
85%
Implementation
100%
Validation
81%| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata' field is not a dictionary | Warning |
license_field | 'license' field is missing | Warning |
body_output_format | No obvious output/return/format terms detected; consider specifying expected outputs | Warning |
Total | 13 / 16 Passed | |
Implementation
100%This is an excellent skill that demonstrates strong technical writing. It provides a complete, actionable workflow for running and verifying a FastAPI server with executable commands, expected outputs, and a practical troubleshooting guide. The content is lean, well-structured, and respects Claude's intelligence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line serves a purpose with no unnecessary explanation of what FastAPI is or how curl works. The troubleshooting table is dense and informative without padding. | 3 / 3 |
Actionability | All commands are copy-paste ready with concrete examples including GET/POST requests, expected outputs (http_code 200), and specific flags. No pseudocode or vague instructions. | 3 / 3 |
Workflow Clarity | Clear numbered sequence from starting server through testing. Includes implicit validation checkpoints (verify docs load, check schema, test endpoints) and a comprehensive troubleshooting table for error recovery. | 3 / 3 |
Progressive Disclosure | For a skill under 50 lines with a single focused task, the content is well-organized with clear sections (Steps, Troubleshooting). No external references needed for this scope. | 3 / 3 |
Total | 12 / 12 Passed |
Activation
85%This is a well-crafted skill description that clearly articulates specific capabilities and includes explicit 'Use when' guidance. The description effectively targets FastAPI-specific workflows. Minor improvement could be made by expanding trigger terms to include related vocabulary users might naturally use.
Suggestions
Consider adding common related terms users might say: 'uvicorn', 'swagger', 'API server', 'REST endpoints', or 'OpenAPI docs'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Start a FastAPI dev server, verify docs and OpenAPI schema, test endpoints, and run pytest' - these are all distinct, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('Start a FastAPI dev server, verify docs and OpenAPI schema, test endpoints, and run pytest') and when ('Use when running, checking, or debugging a FastAPI application') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes good terms like 'FastAPI', 'dev server', 'pytest', 'endpoints', but missing common variations users might say like 'API server', 'uvicorn', 'swagger', 'REST API', or file extensions. | 2 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on FastAPI applications with distinct triggers; unlikely to conflict with general Python, Django, or Flask skills due to explicit FastAPI mentions throughout. | 3 / 3 |
Total | 11 / 12 Passed |
tessl i maria/fastapi@0.1.0