CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fastapi-templates

Create production-ready FastAPI projects with async patterns, dependency injection, and comprehensive error handling. Use when building new FastAPI applications or setting up backend API projects.

68

Quality

86%

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

78%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 skill body: concrete and executable, with accurate progressive disclosure to a verified reference file. The main slack is a small amount of concept-restating bullets and the absence of an explicit step sequence or run command.

DimensionReasoningScore

Conciseness

The body is lean — a compact directory layout, a requirements listing, and focused test code with every token roughly earning its place. The 'Dependency Injection' and 'Async Patterns' bullet lists ("Database session management", "Async route handlers") restate concepts Claude already knows and are the minor over-explanation that keeps it below 5.

4 / 5

Actionability

The body provides an executable directory tree, pinned dependency rationale (e.g. "sqlalchemy[asyncio]>=2.0 # DeclarativeBase; [asyncio] installs greenlet"), and complete copy-paste-ready conftest/test code. Minor gaps: no command to actually run the server (e.g. uvicorn invocation) and the endpoint/service patterns live entirely in the referenced file, so it is not fully comprehensive on its own.

4 / 5

Workflow Clarity

The sections form a coherent sequence (structure → dependencies → detailed patterns → testing) and the runnable pytest suite serves as an explicit validation checkpoint. The sequence itself is implied by section order rather than explicitly numbered, and there is no error-recovery guidance, so it sits at 4 rather than 5.

4 / 5

Progressive Disclosure

The body is a well-organized overview with a clearly signaled, one-level-deep reference: "Detailed sections (starting with `## Implementation Patterns`) live in `references/details.md`. Read that file when the navigation summary above is insufficient." The referenced file exists and indeed begins with that heading, and the split (overview inline, worked patterns external) is appropriate.

5 / 5

Total

17

/

20

Passed

Description

87%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: concrete capability list, explicit and natural "Use when..." triggers, and a clear FastAPI niche. Only minor improvements possible around additional trigger synonyms.

DimensionReasoningScore

Specificity

"Create production-ready FastAPI projects with async patterns, dependency injection, and comprehensive error handling" lists several specific capabilities (async patterns, DI, error handling), matching the 'several specific actions with minor gaps' anchor. It falls short of 5 because the named items are feature areas rather than a comprehensive set of concrete actions.

4 / 5

Completeness

It explicitly answers both: the "what" ("Create production-ready FastAPI projects with async patterns, dependency injection, and comprehensive error handling") and a concrete "when" ("Use when building new FastAPI applications or setting up backend API projects"). The 'when' is explicit with concrete trigger scenarios, matching the top anchor rather than the 4 anchor where the 'when' could be more explicit.

5 / 5

Trigger Term Quality

Natural phrases like "building new FastAPI applications", "setting up backend API projects", and the repeated "FastAPI" give good keyword coverage. A few natural variants users might say ("REST API", "endpoints", "Python", "uvicorn") are missing, so it is not a 5.

4 / 5

Distinctiveness Conflict Risk

"FastAPI" is a clear niche trigger; the description is unlikely to fire for unrelated skills, and its triggers (new FastAPI app, backend API project setup) are distinct. Overlap risk with generic backend scaffolding skills is minimal.

5 / 5

Total

18

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

wshobson/agents

Path

plugins/api-scaffolding/skills/fastapi-templates/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.