fastapi-templates
Create production-ready FastAPI projects with async patterns, dependency injection, and comprehensive error handling. Use when building new FastAPI applications or setting up backend API projects.
Install with Tessl CLI
npx tessl i github:Dicklesworthstone/pi_agent_rust --skill fastapi-templates82
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Discovery
85%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 strong skill description that clearly articulates specific capabilities and includes explicit 'Use when' guidance. The main weakness is the trigger term coverage, which could benefit from additional natural language variations that users might employ when requesting API development help.
Suggestions
Expand trigger terms to include common variations like 'REST API', 'Python API', 'web API', 'endpoints', or 'async Python server' to capture more user queries.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Create production-ready FastAPI projects', 'async patterns', 'dependency injection', and 'comprehensive error handling'. These are concrete, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('Create production-ready FastAPI projects with async patterns, dependency injection, and comprehensive error handling') AND when ('Use when building new FastAPI applications or setting up backend API projects') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes good terms like 'FastAPI', 'backend API projects', and 'applications', but missing common variations users might say like 'REST API', 'web API', 'Python API', 'endpoints', or 'web server'. | 2 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on FastAPI framework with distinct triggers. The combination of 'FastAPI', 'async patterns', and 'dependency injection' creates a unique fingerprint unlikely to conflict with generic Python or web development skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid, actionable FastAPI skill with excellent code examples covering the full stack from configuration to testing. The main weaknesses are verbosity in introductory sections that explain concepts Claude already knows, and lack of explicit step-by-step workflow with validation checkpoints for project setup. The progressive disclosure and code quality are strong.
Suggestions
Remove or condense the 'Core Concepts' section - Claude knows what dependency injection and async patterns are; jump straight to implementation patterns
Add an explicit 'Project Setup Workflow' section with numbered steps and validation checkpoints (e.g., 'Verify database connection before proceeding')
Trim the 'When to Use This Skill' section - this duplicates the skill description and adds little value
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is comprehensive but includes some unnecessary explanations (e.g., 'FastAPI's built-in DI system using Depends' followed by a list of what it does). The 'When to Use This Skill' section and 'Core Concepts' explanations add tokens without providing actionable value Claude doesn't already know. | 2 / 3 |
Actionability | Excellent executable code examples throughout - complete patterns for main.py, repositories, services, endpoints, security, and testing. All code is copy-paste ready with proper imports and realistic implementations. | 3 / 3 |
Workflow Clarity | While the patterns are well-organized, there's no explicit workflow for setting up a new project (e.g., 'Step 1: Create structure, Step 2: Set up database, Step 3: Validate connection'). Missing validation checkpoints for database migrations or testing before deployment. | 2 / 3 |
Progressive Disclosure | Good structure with clear sections progressing from project structure to implementation patterns to testing. References to external files (references/fastapi-architecture.md, assets/project-template/) are well-signaled and one level deep. | 3 / 3 |
Total | 10 / 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 |
|---|---|---|
skill_md_line_count | SKILL.md is long (568 lines); consider splitting into references/ and linking | Warning |
Total | 10 / 11 Passed | |
- 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.