CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fastapi-pro

Build high-performance async APIs with FastAPI, SQLAlchemy 2.0, and Pydantic V2. Master microservices, WebSockets, and modern Python async patterns.

Quality

52%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/antigravity-bundle-python-pro/skills/fastapi-pro/SKILL.md

The canonical home for this skill is fastapi-pro in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

17%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.

This is a persona/resume-style skill, not an instructional one: it exhaustively catalogs FastAPI ecosystem topics Claude already knows, provides zero executable guidance, and points to a nonexistent playbook file. The boilerplate 'Use this skill when' sections are circular ('Working on fastapi pro tasks') and add no routing value. It needs to be rebuilt around concrete, opinionated guidance with real code examples in a properly bundled reference structure.

Suggestions

Replace the capability catalogs with a lean overview of the skill's actual decision rules (e.g., project structure conventions, async session patterns, auth scaffolding) and move any detail into real files under references/, fixing or removing the broken `resources/implementation-playbook.md` pointer.

Add executable content: a minimal copy-paste-ready FastAPI app skeleton (app factory, async SQLAlchemy session dependency, Pydantic V2 model, Alembic setup) covering the common cases the skill is invoked for.

Cut the duplicate persona sections ('You are a FastAPI expert...' / '## Purpose') and the circular 'Use/Do not use' boilerplate, and add explicit validation checkpoints to the workflow (e.g., run pytest, verify the app boots with uvicorn, check OpenAPI docs render).

DimensionReasoningScore

Conciseness

The ~150-line body is dominated by capability catalogs ('### Core FastAPI Expertise', '### Data Management & ORM', etc.) enumerating ecosystem knowledge Claude already has ('- pytest with pytest-asyncio for async tests', '- Docker containerization with multi-stage builds'), plus redundant persona boilerplate duplicated between 'You are a FastAPI expert...' and '## Purpose'. It is above 1 only because the content is list-enumeration rather than didactic explanatory prose; it is far below 3 because nearly every section adds tokens without adding knowledge.

2 / 5

Actionability

There is no code, no command, no configuration example, and no concrete decision guidance anywhere — the closest to instruction is 'Apply relevant best practices and validate outcomes' and 'Design API contracts with Pydantic models first', which are abstract directives Claude could produce unprompted. This matches the lowest anchor: it describes rather than instructs.

1 / 5

Workflow Clarity

'## Response Approach' offers a rough 8-step sequence ('Analyze requirements', 'Design API contracts', 'Implement endpoints'...), but steps are vague labels with no commands or specifics, and validation is entirely absent — no checkpoints, no verify step, no error-recovery loop. It sits between anchors 1 and 2: a sequence exists (above 1), but steps are poorly defined and validation is missing (below 3).

2 / 5

Progressive Disclosure

The body's only external pointer — 'open `resources/implementation-playbook.md`' — targets a file that does not exist in the bundle (there are no references/, scripts/, or assets/ directories at all), so the reference is broken. Meanwhile ~140 lines of capability-list content that clearly belongs in separate reference files are inlined in SKILL.md, matching anchor 2 ('content that clearly belongs in separate files is inlined').

2 / 5

Total

7

/

20

Passed

Description

65%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.

A decent, technology-specific description whose main defects are the missing 'Use when...' trigger clause and buzzword padding ('high-performance', 'Master', 'modern Python async patterns') that inflates without informing. The named stack gives it strong distinctiveness and good trigger terms, but it never tells Claude when to reach for it or enumerates concrete actions.

Suggestions

Add an explicit trigger clause, e.g. 'Use when working with FastAPI, building async Python APIs, or handling SQLAlchemy/Pydantic models in a FastAPI project.'

Replace buzzword padding ('high-performance', 'Master', 'modern async patterns') with concrete actions, e.g. 'Design async endpoints, wire SQLAlchemy 2.0 async sessions, validate request models with Pydantic V2, and add JWT auth, WebSockets, and background tasks.'

Include natural synonym triggers users would say, such as 'REST API', 'Python backend', or 'API endpoints', to broaden matching beyond the exact library names.

DimensionReasoningScore

Specificity

The description names the domain ('Build high-performance async APIs with FastAPI') and gestures at a couple of action areas ('Master microservices, WebSockets'), but these are broad strokes rather than the multiple concrete, enumerable actions of the top anchors. It is above score 2 because the domain is precisely named with concrete technologies (FastAPI, SQLAlchemy 2.0, Pydantic V2), but below 4 because 'Build' and 'Master' are not specific concrete actions like 'extract text' or 'fill forms' — there is no enumeration of what the skill actually does.

3 / 5

Completeness

There is a reasonably clear 'what' (build async APIs with FastAPI/SQLAlchemy/Pydantic), but there is no 'when' clause at all — no 'Use when...' or equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 3. It is above 2 because the 'what' is concrete, and below 4 because the 'when' is entirely missing rather than merely under-specified.

3 / 5

Trigger Term Quality

Good keyword coverage with natural terms users would actually say: 'FastAPI', 'async APIs', 'SQLAlchemy', 'Pydantic', 'WebSockets', 'microservices'. Below 5 because common variations and synonyms are missing (e.g., 'REST API', 'Python backend', 'API endpoints', 'Python web framework'); above 3 because the technology names are strong, distinctive triggers rather than generic phrases.

4 / 5

Distinctiveness Conflict Risk

FastAPI is a clear, well-defined niche with distinct trigger terms ('FastAPI', 'SQLAlchemy 2.0', 'Pydantic V2') that no other plausible skill would claim; conflict risk is minimal. The neighboring anchor 4 ('minor overlap risk') fits less well because the named stack is unambiguous.

5 / 5

Total

15

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/antigravity-bundle-python-pro/skills/fastapi-pro/SKILL.md

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.