CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fastapi-best-practices

FastAPI best practices and conventions. Use when writing, reviewing, or refactoring FastAPI applications — route handlers, Pydantic schemas, dependency injection, project structure, async patterns, testing, or API documentation. Triggers on tasks involving FastAPI routers, endpoints, request validation, response models, or application configuration. Does not cover general Python syntax or typing — see modern-python-development for that.

72

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured, token-efficient overview skill: opinionated FastAPI-specific rules inline, with detail correctly pushed to four real, one-level-deep reference files and clear navigation via a categories table and per-section pointers. The main gap is that the body contains almost no executable code, relying on the reference files for the copy-paste examples.

DimensionReasoningScore

Conciseness

The body is lean and opinionated — every bullet is a terse, non-obvious rule ('`async def` — use ONLY with non-blocking `await` calls; blocks event loop otherwise', 'Table names: `lower_case_snake`, singular (`post`, `user`, `post_like`)') with no explanation of concepts Claude already knows. The only near-redundancy is the 'How to Use' section restating the per-section pointers, which is minor navigation rather than padding, so the anchor-5 fit (every token earns its place) beats anchor 4.

5 / 5

Actionability

Concrete, directly applicable directives appear throughout (`Annotated[T, Depends(fn)]`, `run_in_threadpool()` from Starlette, `openapi_url=None`, `_at`/`_date` column suffixes), and the directory layout is explicit. It is not a 5 because no copy-paste-ready code blocks live in the body — e.g., 'Set up an async test client (httpx + ASGITransport) from day one' names the tools but defers the actual fixture code to a reference file, leaving minor gaps for the common cases.

4 / 5

Workflow Clarity

This is a conventions-reference skill with no multi-step process to sequence; the usage flow (category table → quick-reference rules → 'See references/…' for details) is unambiguous and the 'How to Use' section states it explicitly. It sits at 4 rather than 5 because organization is clear but there is no explicit sequencing or checkpoints — acceptable since no destructive or batch operations are involved, which would otherwise cap the score at 3.

4 / 5

Progressive Disclosure

The body is a clean overview with a categories table mapping each topic to its reference file, per-category summaries, and clearly signaled one-level-deep pointers ('See `references/async-patterns.md` for decision matrix, threadpool caveats, and examples'). All four referenced files (async-patterns.md, dependencies.md, project-conventions.md, pydantic-patterns.md) exist in the bundle, and detail content is appropriately split out — matching the anchor-5 example structure.

5 / 5

Total

18

/

20

Passed

Description

92%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 strong description that clearly and explicitly states what the skill covers, when to use it, and where its boundary lies (delegating general Python to another skill). The only weakness is a handful of missing natural synonyms in the trigger terms.

DimensionReasoningScore

Specificity

It names the domain ('FastAPI best practices and conventions') and enumerates multiple concrete action areas — 'writing, reviewing, or refactoring FastAPI applications — route handlers, Pydantic schemas, dependency injection, project structure, async patterns, testing, or API documentation' — giving comprehensive coverage of the domain, matching the anchor-5 pattern of multiple specific concrete actions rather than the 'minor gaps' of anchor 4.

5 / 5

Completeness

It explicitly answers both questions: the 'what' ('FastAPI best practices and conventions' with enumerated scope) and the 'when' via two explicit trigger clauses — 'Use when writing, reviewing, or refactoring FastAPI applications…' and 'Triggers on tasks involving FastAPI routers, endpoints, request validation, response models, or application configuration.' This matches the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

Good natural keyword coverage: users would genuinely say 'FastAPI routers, endpoints, request validation, response models', 'Pydantic schemas', 'dependency injection'. It falls short of anchor 5's 'comprehensive coverage including synonyms' because common variations like 'REST API', 'backend', 'uvicorn', or 'Starlette' are absent, leaving a few natural terms missing per anchor 4.

4 / 5

Distinctiveness Conflict Risk

Clear niche (FastAPI-specific) with distinct triggers, and it actively defuses the main overlap risk: 'Does not cover general Python syntax or typing — see modern-python-development for that.' A user mentioning FastAPI endpoints or Pydantic schemas would unambiguously land here, matching anchor 5's minimal conflict risk.

5 / 5

Total

19

/

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

provectus/awos-recruitment

Path

registry/skills/fastapi-best-practices/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.