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.

71

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

92%

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

A high-quality, actionable patterns skill with lean prose, executable examples, and useful checklists. The main gap is progressive disclosure: a large amount of code is inline rather than split into referenced detail files.

Suggestions

Move the longer code examples (application factory, dependencies, testing fixture) into referenced files under references/ and keep SKILL.md as an overview with one-level-deep links.

Add a short 'Quick start' or minimal example near the top before the full patterns, so the overview surfaces the essentials first.

DimensionReasoningScore

Conciseness

Lean, directive prose with complete code blocks and no padding explaining what FastAPI/Pydantic/SQLAlchemy are; every section assumes Claude's competence.

3 / 3

Actionability

Multiple complete, copy-paste-ready Python examples with imports (application factory, schemas, dependencies, endpoints, tests, OpenAPI) — fully executable rather than pseudocode.

3 / 3

Workflow Clarity

Clear structural model in 'How It Works', explicit 'When to Use', and Security/Performance checklists that serve as validation checkpoints for complex production work.

3 / 3

Progressive Disclosure

Well-organized into labeled sections, but all ~320 lines of code live inline in SKILL.md with no bundle files splitting detailed patterns into one-level-deep references; the simple-skill exception (under 50 lines) does not apply.

2 / 3

Total

11

/

12

Passed

Description

82%

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 specific, well-targeted description with strong trigger terms and a clear FastAPI niche. Its main weakness is the absence of an explicit 'Use when...' trigger clause, which leaves the 'when to use' guidance only implied.

Suggestions

Append an explicit 'Use when...' clause, e.g. 'Use when building or reviewing FastAPI services, async APIs, or Pydantic schemas.'

Add common user phrasings like 'FastAPI app', 'async endpoints', or 'OpenAPI/Swagger docs' to strengthen natural triggers.

DimensionReasoningScore

Specificity

Lists multiple concrete capabilities — 'async APIs, dependency injection, Pydantic request and response models, OpenAPI docs, tests, security, and production readiness' — rather than vague language.

3 / 3

Completeness

It clearly answers 'what' but lacks an explicit 'when/Use when' trigger clause; per the guidelines, a missing explicit trigger clause caps completeness at 2.

2 / 3

Trigger Term Quality

Natural framework terms a user would say (FastAPI, async APIs, Pydantic, dependency injection, OpenAPI docs) are well covered, matching the 'good coverage of natural terms' anchor.

3 / 3

Distinctiveness Conflict Risk

FastAPI-specific niche with distinct framework triggers, unlikely to conflict with general Python or web skills.

3 / 3

Total

11

/

12

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.

Validation15 / 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.