CtrlK
BlogDocsLog inGet started
Tessl Logo

fastapi-expert

Use when building high-performance async Python APIs with FastAPI and Pydantic V2. Invoke to create REST endpoints, define Pydantic models, implement authentication flows, set up async SQLAlchemy database operations, add JWT authentication, build WebSocket endpoints, or generate OpenAPI documentation. Trigger terms: FastAPI, Pydantic, async Python, Python API, REST API Python, SQLAlchemy async, JWT authentication, OpenAPI, Swagger Python.

68

Quality

82%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

64%

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 that cover the key patterns (Pydantic V2, async CRUD, JWT auth, dependency injection). Its main weaknesses are: the progressive disclosure references point to files that don't exist in the bundle, the workflow validation steps are somewhat generic rather than concrete, and there's some unnecessary verbosity in the intro/constraints sections. The code quality and coverage are the skill's strongest assets.

Suggestions

Create the six referenced files (references/pydantic-v2.md, etc.) or remove the reference table to avoid broken references and improve progressive disclosure.

Add a concrete test example (e.g., a pytest-asyncio test with httpx.AsyncClient) to make the 'Test' workflow step actionable rather than just mentioning pytest.

Trim the 'When to Use This Skill' section and 'Knowledge Reference' keyword list — these duplicate the YAML description and add no actionable value.

Make workflow checkpoints more concrete, e.g., 'Run `pytest tests/test_users.py -v` and verify 201 response for valid input, 409 for duplicate email, 422 for invalid password'.

DimensionReasoningScore

Conciseness

The skill is reasonably efficient but includes some unnecessary framing (e.g., 'Deep expertise in async Python...' intro, the 'Knowledge Reference' keyword list at the bottom, and the 'When to Use This Skill' section which largely restates the description). The constraints section has some items Claude already knows (e.g., 'Store passwords in plain text', 'Expose sensitive data'). However, the code examples are lean and purposeful.

2 / 3

Actionability

The skill provides fully executable, copy-paste-ready code examples covering schemas, endpoints, CRUD operations, and JWT authentication. The code is complete with proper imports, type hints, and realistic patterns. The dependency injection pattern with `Annotated` and the full JWT flow are concrete and immediately usable.

3 / 3

Workflow Clarity

The core workflow lists 5 steps with a checkpoint note, but the validation steps are somewhat vague ('confirm schemas validate correctly', 'endpoints return expected HTTP status codes'). It mentions running pytest but doesn't show a concrete test example or validation command. For a skill involving database operations and authentication, more explicit verification steps (e.g., run migrations, verify DB connection, test auth flow) would strengthen this.

2 / 3

Progressive Disclosure

The reference table is well-structured with clear 'Load When' triggers, which is excellent design. However, no bundle files are provided, so all six referenced files (references/pydantic-v2.md, etc.) are missing. The skill content itself is fairly long (~150 lines of code examples) that could potentially be split into referenced files, keeping the SKILL.md as a leaner overview.

2 / 3

Total

9

/

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 excels across all dimensions. It provides specific concrete actions, comprehensive trigger terms that match natural developer language, explicit 'Use when' and 'Invoke to' guidance, and a clearly defined niche around FastAPI/Pydantic V2 async Python development. The description is well-structured and concise without unnecessary padding.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: create REST endpoints, define Pydantic models, implement authentication flows, set up async SQLAlchemy database operations, add JWT authentication, build WebSocket endpoints, generate OpenAPI documentation.

3 / 3

Completeness

Clearly answers both 'what' (create REST endpoints, define Pydantic models, implement auth flows, etc.) and 'when' (explicitly starts with 'Use when building high-performance async Python APIs with FastAPI and Pydantic V2' and includes explicit trigger terms).

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: FastAPI, Pydantic, async Python, Python API, REST API Python, SQLAlchemy async, JWT authentication, OpenAPI, Swagger Python. These are terms developers would naturally use when requesting help in this domain.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche around FastAPI + Pydantic V2 + async Python. The combination of specific framework names (FastAPI, Pydantic V2, SQLAlchemy async) and explicit trigger terms makes it very unlikely to conflict with generic Python or web development skills.

3 / 3

Total

12

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
Jeffallan/claude-skills
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.