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.

Quality

77%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./skills/fastapi-expert/SKILL.md

Quality

Content

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

Description

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

Validation

75%

Warnings & errors only

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: 5 months ago

Table of Contents

Discovery Implementation Validation

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.