Back to catalog
Human reviewedDevelopment

Skill dossier

fastapi-expert

Source declaration

Use when building high-performance async Python APIs with FastAPI and Pydantic V2. Invoke to create REST endpoints, define Pydantic models, implement authentication flows, set up async SQLAlchemy database operations, add JWT authentication, build WebSocket endpoints, or generate OpenAPI documentation. Trigger terms: FastAPI, Pydantic, async Python, Python API, REST API Python, SQLAlchemy async, JWT authentication, OpenAPI, Swagger Python.

The author's original description, preserved in English. It describes intent, not verified performance.

Use when building high-performance async Python APIs with FastAPI and Pydantic V2. Invoke to create REST endpoints, define Pydantic models, implement authentication flows, set up async SQLAlchemy database operations, add JWT authentication, build WebSocket endpoints, or generate OpenAPI documentation. Trigger terms: FastAPI, Pydantic, async Python, Python API, REST API Python, SQLAlchemy async, JWT authentication, OpenAPI, Swagger Python.

developmentreferences

Research summary

Human reviewed

Skill Atlas editorial review · editorial-preview-1.0.0

A backend Skill for async Python APIs with FastAPI and Pydantic V2, covering schemas, async SQLAlchemy, JWT authentication and pytest-based checks with an OpenAPI review.

Review scope

Deterministic static analysis of collected SKILL.md and supporting text/code. Machine-assisted candidates and findings await human editorial review; no dynamic behavior or effect is assessed.

Observable capabilities

  • Designs Pydantic V2 schemas using field_validator and model_config.
  • Writes async endpoints with Annotated dependency injection and async SQLAlchemy CRUD.
  • Adds JWT and OAuth2 authentication, authorization and rate limiting.
  • Runs pytest with httpx after each endpoint group and verifies the OpenAPI docs at /docs.

Limitations & scope

  • Specific to FastAPI and Pydantic V2; Pydantic V1 syntax is explicitly disallowed.
  • The inline JWT snippet uses a placeholder secret that must come from configuration in real code.
  • Generated endpoints and tests have not been run here.

Relevant for

  • Python developers building async REST APIs
  • Teams migrating from Django or DRF to FastAPI

What ships with the skill

The file inventory comes from the collected source at the recorded commit. Paths and sizes are structural observations, not a measure of quality.

files
7
Markdown files
7
scripts
0
references
6
Size
54 KB
Structural complexity
Low

File inventory

PathTypeBytes
skills/fastapi-expert/references/async-sqlalchemy.mdReference4 KB
skills/fastapi-expert/references/authentication.mdReference4.3 KB
skills/fastapi-expert/references/endpoints-routing.mdReference4 KB
skills/fastapi-expert/references/migration-from-django.mdReference27 KB
skills/fastapi-expert/references/pydantic-v2.mdReference3.3 KB
skills/fastapi-expert/references/testing-async.mdReference4.5 KB
skills/fastapi-expert/SKILL.mdInstruction6.9 KB

SKILL.md frontmatter

{
  "name": "fastapi-expert",
  "description": "Use when building high-performance async Python APIs with FastAPI and Pydantic V2. Invoke to create REST endpoints, define Pydantic models, implement authentication flows, set up async SQLAlchemy database operations, add JWT authentication, build WebSocket endpoints, or generate OpenAPI documentation. Trigger terms: FastAPI, Pydantic, async Python, Python API, REST API Python, SQLAlchemy async, JWT authentication, OpenAPI, Swagger Python.",
  "license": "MIT",
  "metadata": {
    "author": "https://github.com/Jeffallan",
    "company": "https://synergetic.solutions",
    "version": "1.1.0",
    "domain": "backend",
    "triggers": "FastAPI, Pydantic, async Python, Python API, REST API Python, SQLAlchemy async, JWT authentication, OpenAPI, Swagger Python",
    "role": "specialist",
    "scope": "implementation",
    "output-format": "code",
    "related-skills": "fullstack-guardian, django-expert, test-master"
  }
}

A reading of the operating sequence

This workflow reconstructs the apparent sequence from source material. Unless controlled evaluation is explicitly recorded, it is provisional—not an observed trace.

  1. 01
    Input

    Analyze requirements

    Identify endpoints, data models and authentication needs.

  2. 02
    Action

    Design schemas and implement

    Create Pydantic V2 models and write async endpoints with dependency injection.

  3. 03
    Decision

    Checkpoint each step

    Confirm schemas validate, endpoints return the expected status codes and /docs reflects the intended API before proceeding.

  4. 04
    Output

    Deliver schemas and routers

    Provide the schema file, router file, CRUD operations if needed and a brief explanation of key decisions.

Potential risk surfaces

Static findings identify points to inspect before installation. They do not establish that a skill is safe, malicious, or effective.

Attention recommended

82 deterministic lexical finding(s) require review across the collected text. Findings can occur in documentation and do not prove execution or exploitability; binary-only files were not scanned.

Network accessObserved
File writesObserved
Credential useObserved
High

Credential or secret material is referenced

15 occurrences

This line resembles a credential literal or reads a sensitive environment value. Do not expose its contents; verify whether it is a placeholder, required secret, or accidentally committed material. This rule matched 15 location(s) in the collected text; 3 representative location(s) are cited. Matching text may be documentation, and the analyzer did not execute it.

Note

File modification is described or implemented

58 occurrences

This line contains a possible file-write or redirection operation. Check destination paths and overwrite behavior; the static review did not write any file. This rule matched 58 location(s) in the collected text; 3 representative location(s) are cited. Matching text may be documentation, and the analyzer did not execute it.

Medium

Network access is mentioned

9 occurrences

A URL or network client appears in this source line. Review destinations, data sent, and trust boundaries; static text cannot establish actual network activity. This rule matched 9 location(s) in the collected text; 3 representative location(s) are cited. Matching text may be documentation, and the analyzer did not execute it.

Editorial security note

Confirm the JWT secret and any configuration values come from the environment and that passwords are hashed before use.

Where context can be spent

Discovery, activation, and resource layers have different meanings. Exact values appear only when the official token-counting method was run with a named model.

Exact token counts unavailable

All token values, including per-file inventory, are null until the pipeline performs an official exact count with an explicit model.

No token measurement was recorded with the required official method. This dossier does not substitute character counts, file sizes, or estimates.

Controlled evaluation

No controlled evaluation

This skill has only the evidence identified above. No task success, token efficiency, latency, or quality advantage is claimed.

Not tested

Use with the source in view

Install command
git clone https://github.com/Jeffallan/claude-skills.git cd claude-skills # Copy this skill directory into one of: # ~/.claude/skills/fastapi-expert # .claude/skills/fastapi-expert
  1. Open the pinned source at https://github.com/Jeffallan/claude-skills/blob/67c1961b180dc92cf08983344627109e983e8f51/skills/fastapi-expert/SKILL.md.
  2. Review the license, prerequisites and all bundled reference files.
  3. Copy the skill directory into a personal or project-level Claude Code skills directory.
  4. Restart or refresh Claude Code so the skill can be discovered.
Verify installation

Ask Claude Code to add one endpoint and confirm it runs pytest and checks the /docs page.

Prerequisites

  • Specific to FastAPI and Pydantic V2; Pydantic V1 syntax is explicitly disallowed.
  • The inline JWT snippet uses a placeholder secret that must come from configuration in real code.
  • Generated endpoints and tests have not been run here.

Example prompts

Representative task

Use the fastapi-expert skill to add a POST /users endpoint with a Pydantic V2 UserCreate schema, async SQLAlchemy persistence, a 409 on duplicate email, and pytest tests using httpx.

Inspect before use

Read the fastapi-expert skill at https://github.com/Jeffallan/claude-skills/blob/67c1961b180dc92cf08983344627109e983e8f51/skills/fastapi-expert/SKILL.md. Explain its workflow, required tools, permissions and the main risks before I decide whether to install it.

A decision, with its limits attached

Strengths

  • Adds a checkpoint after each step covering schemas, status codes and /docs.
  • Rules are explicit about async I/O, Annotated dependencies and password handling.

Considerations

  • Example imports in the snippet should be checked against the installed Pydantic version.
  • Mandating async everywhere may not suit existing sync codebases.
Research conclusion

A tidy, checkpoint-driven guide for new FastAPI services that follows current Pydantic V2 conventions.

Traceable by construction

The dossier is a time-bound reading of a public artifact, not an endorsement. Use the source link to inspect the exact upstream material.

Jeffallanclaude-skillsskills/fastapi-expert
Source type
Community
Commit
67c1961b180dc92cf08983344627109e983e8f51
Collected
20 Nov 2026
Last checked
20 Nov 2026
Upstream license
MIT
Repository stars
12,464
Content basis

Deterministic lexical parsing, YAML frontmatter validation, file inventory, source-described workflow extraction, and heuristic provisional classification of the supplied files only. Generated by machine; no LLM, execution, dynamic testing, or human editorial approval.