CtrlK
BlogDocsLog inGet started
Tessl Logo

fastapi-patterns

FastAPI patterns for async APIs, dependency injection, Pydantic request and response models, OpenAPI docs, tests, security, and production readiness.

62

Quality

74%

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 ./.kiro/skills/fastapi-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 strong, production-oriented body: executable, complete code for every pattern, lean prose that assumes competence, and useful hardening checklists. Its only notable weaknesses are a slightly redundant closing 'Examples' section, no explicit multi-step workflow with validation checkpoints, and a long single-file layout that could offload detail to reference files.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence — no padding about what FastAPI or Pydantic is — and each section pairs two sentences of guidance with executable code, matching the 'efficient; minor instances of over-explanation' anchor. It misses 5 because the trailing 'Examples' section largely restates points already demonstrated by the code sections.

4 / 5

Actionability

Every pattern ships complete, copy-paste-ready code (application factory, Pydantic schema split, DI, async endpoints, exception handlers, OpenAPI customization, test fixture with dependency overrides) plus concrete security and performance checklists. This matches 'fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

'How It Works' gives a coherent architectural model (thin HTTP layer over explicit dependencies and service code) and the security/performance checklists act as review checkpoints, but there is no explicit multi-step sequence for building or reviewing an app. This sits at 'clear sequence with most checkpoints present; minor gaps' rather than 5, which requires explicit validation steps and feedback loops.

4 / 5

Progressive Disclosure

This is a single-file skill with no bundle directories, and the body is well organized into clear, navigable sections ('When to Use' through 'See Also'). It matches 'good structure; most content is appropriately placed; minor organization gaps' rather than 5, because at ~325 lines some self-contained material (e.g. the pattern-by-pattern examples or checklists) could be split into one-level-deep reference files.

4 / 5

Total

17

/

20

Passed

Description

66%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 solid, keyword-rich description with a clear FastAPI niche and good trigger-term coverage, weakened by the absence of any explicit 'when to use' clause. Adding a 'Use when...' sentence would raise completeness and overall fit to the exemplar descriptions.

Suggestions

Append an explicit trigger clause, e.g. 'Use when building, reviewing, or debugging a FastAPI app, or when the user mentions FastAPI, Pydantic models, dependency injection, or OpenAPI docs.'

Phrase capabilities as concrete actions rather than topic nouns (e.g. 'Structure routers, schemas, and dependencies; write async endpoints; harden auth and OpenAPI docs') to sharpen specificity.

Add one or two natural synonyms users actually say (e.g. 'REST API', 'JWT auth', 'SQLAlchemy') to round out trigger-term coverage.

DimensionReasoningScore

Specificity

The description lists several concrete capability areas ('async APIs, dependency injection, Pydantic request and response models, OpenAPI docs, tests, security, and production readiness'), which matches the 'several specific actions; minor gaps' anchor. It falls short of 5 because it names topics/domains rather than multiple distinct concrete actions.

4 / 5

Completeness

The 'what' is clear (FastAPI patterns covering DI, Pydantic models, OpenAPI, tests, security), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric guidelines. It is not 4 because the 'when' is entirely absent rather than merely implicit or weak.

3 / 5

Trigger Term Quality

Natural terms a FastAPI user would say are present ('FastAPI', 'async APIs', 'dependency injection', 'Pydantic', 'OpenAPI'), matching 'good keyword coverage; a few natural terms missing'. Not 5 because it lacks common phrasings users might use, such as 'REST API', 'JWT', or 'SQLAlchemy'.

4 / 5

Distinctiveness Conflict Risk

The description is anchored to a clear FastAPI niche with distinct triggers ('FastAPI patterns', 'Pydantic request and response models'), but has minor overlap risk with closely related general skills like python-patterns or api-design. It does not reach 5 because generic terms such as 'security' and 'production readiness' could match broader web-backend skills.

4 / 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
affaan-m/ECC
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.