fastapi-router
Create FastAPI routers with CRUD operations, authentication dependencies, and proper response models. Use when building REST API endpoints, creating new routes, implementing CRUD operations, or adding authenticated endpoints in FastAPI applications.
96
93%
Does it follow best practices?
Impact
100%
1.81xAverage score across 3 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 a well-crafted skill description that follows best practices. It uses third person voice, lists specific concrete actions, includes natural trigger terms developers would use, and has an explicit 'Use when...' clause that clearly defines when to select this skill. The FastAPI-specific terminology makes it highly distinctive.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Create FastAPI routers', 'CRUD operations', 'authentication dependencies', and 'proper response models'. These are concrete, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('Create FastAPI routers with CRUD operations, authentication dependencies, and proper response models') AND when ('Use when building REST API endpoints, creating new routes, implementing CRUD operations, or adding authenticated endpoints'). | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'REST API endpoints', 'routes', 'CRUD operations', 'authenticated endpoints', 'FastAPI'. Good coverage of terms developers naturally use when building APIs. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on FastAPI with distinct triggers like 'FastAPI applications', 'routers', and 'authentication dependencies'. Unlikely to conflict with general Python or other web framework skills. | 3 / 3 |
Total | 12 / 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 well-crafted skill that efficiently communicates FastAPI router patterns with executable code examples and good use of external templates. The main weakness is the integration steps section, which lists actions without validation checkpoints to verify successful integration.
Suggestions
Add a validation step after mounting the router (e.g., 'Verify: `curl http://localhost:8000/docs` shows new endpoints')
Consider adding a brief troubleshooting note for common integration failures (e.g., missing import, router not appearing in docs)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section is lean and purposeful. No explanation of what FastAPI is or how routers work—assumes Claude's competence. Placeholder syntax is efficient and clear. | 3 / 3 |
Actionability | Provides executable Python code snippets for auth patterns, response models, and status codes. The template reference with clear placeholder substitution rules makes this copy-paste ready. | 3 / 3 |
Workflow Clarity | Integration steps are listed but lack validation checkpoints. No verification step after mounting the router or creating models—missing feedback loop for catching integration errors. | 2 / 3 |
Progressive Disclosure | Clean structure with quick start pointing to external template file. Sections are well-organized and the template reference keeps the main file concise while providing full implementation details elsewhere. | 3 / 3 |
Total | 11 / 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
- microsoft/agent-skills
- Commit
f698f69
- 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.