CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

78

1.11x
Quality

52%

Does it follow best practices?

Impact

95%

1.11x

Average score across 6 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/api-scaffolding/skills/fastapi-templates/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

75%

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 solid description that clearly identifies its niche (FastAPI project creation) and includes an explicit 'Use when' clause. Its main weaknesses are that the capabilities listed are more about qualities (async patterns, dependency injection) than concrete actions, and the trigger terms could include more natural variations users might use when requesting API development help.

Suggestions

Add more concrete actions like 'scaffold routes, configure middleware, set up Pydantic models, define database schemas' to increase specificity.

Expand trigger terms to include natural variations like 'REST API', 'Python API', 'web server', 'endpoints', '.py backend' to improve discoverability.

DimensionReasoningScore

Specificity

Names the domain (FastAPI) and some patterns (async patterns, dependency injection, error handling), but doesn't list multiple concrete actions like 'create routes, configure middleware, set up database models'. The actions are more about qualities of the output than specific tasks.

2 / 3

Completeness

Clearly answers both 'what' (create production-ready FastAPI projects with async patterns, dependency injection, error handling) and 'when' (when building new FastAPI applications or setting up backend API projects) with an explicit 'Use when' clause.

3 / 3

Trigger Term Quality

Includes 'FastAPI', 'backend API', and 'API projects' which are relevant keywords, but misses common variations users might say like 'REST API', 'Python API', 'web server', 'endpoints', 'ASGI', or 'uvicorn'.

2 / 3

Distinctiveness Conflict Risk

FastAPI is a specific framework, making this clearly distinguishable from general Python skills, Django skills, or Flask skills. The triggers are distinct enough to avoid conflicts with other skills.

3 / 3

Total

10

/

12

Passed

Implementation

29%

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

The skill provides comprehensive, executable FastAPI code patterns but fails significantly on structure and efficiency. It's a monolithic code dump (~400+ lines) with no workflow sequencing, no progressive disclosure via external references, and unnecessary explanatory sections about concepts Claude already understands. The actionability is its sole strength.

Suggestions

Add a clear numbered workflow: 'Step 1: Create project structure, Step 2: Configure database, Step 3: Define models...' with validation checkpoints (e.g., 'Run uvicorn to verify startup before adding routes').

Split the inline patterns into separate referenced files (e.g., REPOSITORY_PATTERN.md, AUTH_PATTERN.md, TESTING.md) and keep SKILL.md as a concise overview with links.

Remove the 'Core Concepts' and 'When to Use This Skill' sections entirely—Claude knows what DI, async patterns, and FastAPI are.

Trim the base repository pattern to just the class signature and one method as an example, referencing a full file for the complete implementation.

DimensionReasoningScore

Conciseness

Extremely verbose at ~400+ lines. The 'Core Concepts' section explains DI, async patterns, and project structure concepts Claude already knows. The 'When to Use This Skill' section is unnecessary padding. Much of the code could be condensed or split into referenced files.

1 / 3

Actionability

The code examples are fully executable and copy-paste ready, covering the complete stack from main.py through repositories, services, endpoints, security, and testing. Concrete patterns with real imports and type annotations.

3 / 3

Workflow Clarity

There is no sequenced workflow for setting up a project. The skill presents patterns but never says 'Step 1: create config, Step 2: set up database, Step 3: create models...' There are no validation checkpoints, no verification steps, and no guidance on order of operations for building the project.

1 / 3

Progressive Disclosure

Monolithic wall of code with no references to external files. All patterns are inlined in a single massive document. The project structure, repository pattern, service layer, auth, and testing could each be separate referenced files with a concise overview in the main skill.

1 / 3

Total

6

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (541 lines); consider splitting into references/ and linking

Warning

Total

10

/

11

Passed

Repository
wshobson/agents
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.