fastapi-pro

Build high-performance async APIs with FastAPI, SQLAlchemy 2.0, and Pydantic V2. Master microservices, WebSockets, and modern Python async patterns. Use PROACTIVELY for FastAPI development, async optimization, or API architecture.

Quality

50%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

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

Quality

Content

25%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is an over-long capabilities catalog with no executable code, no concrete workflows, and no validation checkpoints, relying on generic boilerplate for the core instructions. It needs to be replaced with actionable, code-driven guidance and offloaded detail to reference files.

Suggestions

Replace the generic capability bullet lists with a concise quick-start containing executable FastAPI code (e.g., an async endpoint with Pydantic V2 model and SQLAlchemy 2.0 session).

Add explicit validation checkpoints to the Response Approach workflow, especially for database migrations and deployment steps (e.g., 'Run pytest-asyncio; only deploy when tests pass').

Move the long capability/topic catalogs into separate reference files (references/) and link to them one level deep instead of inlining everything in SKILL.md.

Dimension	Reasoning	Score
Conciseness	The body is a large catalog of generic capability bullet lists ('FastAPI 0.100+ features including Annotated types', 'OAuth2 with JWT tokens (python-jose, pyjwt)') that largely restate knowledge Claude already has about these libraries, with no executable detail to justify the length.	2 / 5
Actionability	Despite covering many topics, there is no executable code, no commands, and no concrete steps — the Instructions section is generic boilerplate ('Apply relevant best practices and validate outcomes') and the body only describes rather than instructs.	2 / 5
Workflow Clarity	The 'Response Approach' gives a rough 8-step sequence but steps are abstract ('Design API contracts with Pydantic models first'), with no validation checkpoints despite the skill covering destructive/batch operations like database migrations and deployment.	2 / 5
Progressive Disclosure	The SKILL.md is a monolithic inline catalog of capability bullets that should be split into reference files, and no bundle files (references/, scripts/, assets/) exist despite the breadth of topics implying detailed material belongs elsewhere.	2 / 5
	Total	8 / 20 Passed

Description

76%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, names the exact technology stack, and provides clear proactive trigger guidance, making it well-scoped and distinct. It is solid but could tighten 'Master ... patterns' into more concrete actions and expand trigger synonyms.

Suggestions

Replace the abstract 'Master microservices, WebSockets, and modern Python async patterns' with concrete actions (e.g., 'Implement JWT auth, async SQLAlchemy sessions, and WebSocket endpoints').

Add common user synonyms such as 'async API', 'REST backend', or 'Python web service' to broaden natural trigger coverage.

Make the 'when' clause more explicit by listing concrete trigger scenarios rather than a single 'Use PROACTIVELY for...' sentence.

Dimension	Reasoning	Score
Specificity	Names the domain (FastAPI, SQLAlchemy 2.0, Pydantic V2) and several concrete capability areas (async APIs, microservices, WebSockets), though 'Master ... patterns' is somewhat abstract and the actions are higher-level category names rather than granular operations.	4 / 5
Completeness	Clearly states what the skill does ('Build high-performance async APIs with FastAPI, SQLAlchemy 2.0, and Pydantic V2. Master microservices, WebSockets...') and when to use it ('Use PROACTIVELY for FastAPI development, async optimization, or API architecture'), though the trigger clause could be more explicitly enumerated.	4 / 5
Trigger Term Quality	Includes natural user-facing phrases like 'FastAPI development', 'async optimization', and 'API architecture', with good keyword coverage, but is missing common synonyms or file/extension variations a user might say.	4 / 5
Distinctiveness Conflict Risk	The FastAPI + SQLAlchemy 2.0 + Pydantic V2 niche with explicit proactive triggers is clearly distinct from generic Python or web skills, with minimal conflict risk.	5 / 5
	Total	17 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning

	Total	15 / 16 Passed

Repository: rmyndharis/antigravity-skills
Path: skills/fastapi-pro/SKILL.md
Commit: 3eff4af

Reviewed: 1 day 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.