fastapi-expert
Expert FastAPI developer specializing in production-ready async REST APIs with Pydantic v2, SQLAlchemy 2.0, OAuth2/JWT authentication, and comprehensive security. Deep expertise in dependency injection, background tasks, async database operations, input validation, and OWASP security best practices. Use when building high-performance Python web APIs, implementing authentication systems, or securing API endpoints.
76
77%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/fastapi-expert/SKILL.mdQuality
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 strong skill description that clearly identifies the FastAPI domain with specific technologies (Pydantic v2, SQLAlchemy 2.0, OAuth2/JWT), lists concrete capabilities (dependency injection, background tasks, async operations), and includes an explicit 'Use when...' clause with natural trigger scenarios. The description uses proper third-person voice and provides sufficient detail for Claude to distinguish this skill from general Python or other web framework skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and technologies: 'async REST APIs with Pydantic v2, SQLAlchemy 2.0, OAuth2/JWT authentication', 'dependency injection, background tasks, async database operations, input validation, and OWASP security best practices'. | 3 / 3 |
Completeness | Clearly answers both what (FastAPI development with specific technologies and capabilities) AND when ('Use when building high-performance Python web APIs, implementing authentication systems, or securing API endpoints'). | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'FastAPI', 'REST APIs', 'Pydantic', 'SQLAlchemy', 'OAuth2', 'JWT', 'authentication', 'Python web APIs', 'API endpoints'. Good coverage of framework names and common terms. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on FastAPI with distinct triggers like 'FastAPI', 'Pydantic v2', 'SQLAlchemy 2.0', 'OAuth2/JWT'. Unlikely to conflict with general Python or other web framework skills due to specific technology stack. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
55%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides excellent actionable code examples and clear TDD workflows, but is severely bloated with redundant content and explanations of concepts Claude already knows. The lack of progressive disclosure makes it a monolithic document that wastes context window space. The content would be significantly more effective at 1/3 the length with proper file separation.
Suggestions
Remove the Overview section listing Claude's capabilities and the 'You build FastAPI applications that are...' descriptions - Claude doesn't need to be told what it knows
Extract detailed patterns into separate files (e.g., SECURITY.md, PERFORMANCE.md, TESTING.md) and reference them from a concise main skill file
Consolidate redundant examples - password hashing, CORS warnings, and async patterns each appear multiple times
Remove explanatory text like 'PDF (Portable Document Format)' equivalents - e.g., 'Pydantic v2: Advanced validation, custom validators...' just show the code patterns
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at ~800+ lines with significant redundancy. Explains concepts Claude already knows (what async/await is, what Pydantic does, basic security concepts). Multiple sections repeat the same patterns (e.g., password hashing appears 4+ times, CORS warnings repeated). The overview section lists capabilities Claude inherently has. | 1 / 3 |
Actionability | Provides fully executable, copy-paste ready code examples throughout. All patterns include complete Python code with imports, proper async syntax, and realistic implementations. Testing examples are comprehensive with working fixtures and assertions. | 3 / 3 |
Workflow Clarity | Clear TDD workflow with explicit steps (write test → implement → refactor → verify). Includes validation checkpoints like 'Run Full Verification' with specific commands. Pre-implementation checklist provides explicit phase-based validation. Testing workflow includes coverage requirements. | 3 / 3 |
Progressive Disclosure | Monolithic wall of text with no references to external files. All content is inline despite being 800+ lines. No separation of concerns - API reference, security patterns, performance patterns, and testing all crammed into one file. Could easily be split into SECURITY.md, PATTERNS.md, TESTING.md, etc. | 1 / 3 |
Total | 8 / 12 Passed |
Validation
75%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 12 / 16 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (1176 lines); consider splitting into references/ and linking | Warning |
metadata_version | 'metadata' field is not a dictionary | Warning |
license_field | 'license' field is missing | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 12 / 16 Passed | |
- Repository
- martinholovsky/claude-skills-generator
- Commit
1086ef2
- 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.