fastapi · itechmeat — скилл для Claude Code: что делает и как установить
Скилл для Claude Code помогает создавать Python API на FastAPI. Он включается при работе с REST-маршрутами, Pydantic-моделями, зависимостями и OAuth2/JWT.
MIT 100 установок ★ 23 обновлён 2026-10-24
npx skills add itechmeat/llm-code --skill fastapi -a claude-codeЧто делает fastapi
Скилл даёт инструкции по созданию API на FastAPI: настройке маршрутов и параметров запросов, проверке данных, обработке ошибок, зависимостям и безопасности. Также затрагивает CORS, middleware, загрузку файлов, тесты, WebSocket и работу с базами данных.
Материалы разбиты по темам в файлы references/, включая отдельные руководства по моделям, аутентификации и тестированию. Для самого FastAPI нужен Python 3.10 или новее. Полный вариант устанавливается командой pip install "fastapi[standard]" и включает uvicorn; минимальный — pip install fastapi. Для форм и файлов нужен python-multipart.
Какие задачи решает
- создать REST API на Python с FastAPI
- добавить проверку параметров и тела запроса
- настроить OAuth2/JWT и внедрение зависимостей
- покрыть тестами конечные точки API
Примеры запросов агенту
- Создай REST API на FastAPI с проверкой тела запроса через Pydantic.
- Настрой OAuth2/JWT и внедрение зависимостей в моём приложении.
- Добавь загрузку файлов и тесты для конечных точек API.
Как установить fastapi
1Через Skills CLI (Vercel)
npx skills add itechmeat/llm-code --skill fastapi -a claude-code2Вручную: положить файлы
~/.claude/skills/fastapi/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/fastapi/
1Через Skills CLI (Vercel)
npx skills add itechmeat/llm-code --skill fastapi -a codex2Вручную: положить файлы
.agents/skills/fastapi/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add itechmeat/llm-code --skill fastapi -a cursor2Вручную: положить файлы
.cursor/skills/fastapi/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install itechmeat/llm-code skills/fastapi2Вручную: положить файлы
.github/skills/fastapi/SKILL.md1Через Skills CLI (Vercel)
npx skills add itechmeat/llm-code --skill fastapi -a gemini-cli2Командой платформы
gemini skills install https://github.com/itechmeat/llm-code --path skills/fastapiВручную: положить файлы
.devin/skills/fastapi/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add itechmeat/llm-code --skill fastapi -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о fastapi
Как установить fastapi в Claude Code?
Выполни npx skills add itechmeat/llm-code --skill fastapi -a claude-code. Файл скилла находится по пути ~/.claude/skills/fastapi/SKILL.md.
Что делает fastapi?
Скилл помогает разрабатывать API на FastAPI: настраивать маршруты, валидацию, Pydantic-модели, зависимости и безопасность. В материалах также есть темы тестирования, файлов и WebSocket.
Что нужно для работы fastapi?
Для FastAPI нужен Python 3.10 или новее. Полная установка: pip install "fastapi[standard]"; минимальная: pip install fastapi. Для форм и файлов дополнительно нужен python-multipart.
Исходный текст
SKILL.md · MIT
---
name: fastapi
description: "FastAPI Python framework. Covers REST APIs, validation, dependencies, security. Use when building Python web APIs with FastAPI, configuring Pydantic models, implementing dependency injection, or setting up OAuth2/JWT authentication. Keywords: FastAPI, Pydantic, async, OAuth2, JWT, REST API."
metadata:
version: "0.159.1"
release_date: "2026-10-21"
---
# FastAPI
This skill provides comprehensive guidance for building APIs with FastAPI.
## Quick Navigation
| Topic | Reference |
| ------------------ | ----------------------------------- |
| Getting started | `references/first-steps.md` |
| Path parameters | `references/path-parameters.md` |
| Query parameters | `references/query-parameters.md` |
| Request body | `references/request-body.md` |
| Validation | `references/validation.md` |
| Cookies/Headers | `references/cookies-headers.md` |
| Pydantic models | `references/models.md` |
| Forms/Files | `references/forms-files.md` |
| Error handling | `references/error-handling.md` |
| Path config | `references/path-config.md` |
| Dependencies | `references/dependencies.md` |
| Security | `references/security.md` |
| Telemetry | `references/telemetry.md` |
| Middleware | `references/middleware.md` |
| CORS | `references/cors.md` |
| Database | `references/sql-databases.md` |
| Project structure | `references/bigger-applications.md` |
| Background tasks | `references/background-tasks.md` |
| Metadata/Docs | `references/metadata-docs.md` |
| Testing | `references/testing.md` |
| Advanced responses | `references/responses-advanced.md` |
| WebSockets | `references/websockets.md` |
| Templates | `references/templates.md` |
| Settings/Env vars | `references/settings.md` |
| Lifespan events | `references/lifespan.md` |
| OpenAPI advanced | `references/openapi-advanced.md` |
## When to Use
- Creating REST APIs with Python
- Adding endpoints with automatic validation
- Implementing OAuth2/JWT authentication
- Working with Pydantic models
- Adding dependency injection
- Configuring CORS, middleware
- Uploading files, handling forms
- Testing API endpoints
## Installation
Requires Python 3.10+. Install: `pip install "fastapi[standard]"` (full with uvicorn) or `pip install fastapi` (minimal). Add `python-multipart` for forms/files.
## Release Highlights (0.141.1 -> 0.159.1)
Breaking changes first — each one changes runtime behavior for existing code.
- **Breaking — `**extra` removed from request parameters (`0.155.0`)**: `Path`, `Query`, `Header`, `Cookie`, `Body`, `Form`, and `File` no longer accept arbitrary keyword arguments; unknown kwargs now raise `TypeError`. Use `json_schema_extra={"custom": "value"}` instead of `Query(custom="value")`. See `references/validation.md`.
- **Breaking — `root_path` deprecated (`0.146.0`)**: `FastAPI(root_path=...)` is deprecated. Configure the server instead: `fastapi run --root-path /api/v1`.
- **Breaking — `openapi_prefix` and `FastAPI(**extra)` removed (`0.145.0`)**: both were deprecated and are gone; `FastAPI()` now rejects them.
- **Breaking — OpenTelemetry auto-configuration is opt-in (`0.143.0`)**: FastAPI no longer sets up exporters from `OTEL_*` environment variables on its own. Set `FASTAPI_OTEL_AUTO_CONFIGURE=true` or `FastAPI(telemetry={"auto_configure": True})` to keep the old behavior. Apps that configure their own providers/exporters need no change. See `references/telemetry.md`.
- **Breaking — form values follow browser semantics (`0.147.0` – `0.153.0`)**: omitted `bool`/`bool | None` form fields become `False` and count as explicitly set (`0.147.0`); empty scalar form values are treated as missing — required fields error, fields with defaults use the default and stay unset in `model_dump(exclude_unset=True)`, empty strings inside lists are preserved (`0.149.0`); unselected browser file inputs (empty filename and content) are treated as missing (`0.150.0`); unions of form models follow the same rules (`0.153.0`).
- **Breaking — JSON `null` is not an omitted value (`0.151.0`)**: `null` in a JSON body is validated as `None` — nullable types accept it, non-nullable types reject it even when a default exists. Defaults and default factories apply only when the value is omitted. Sending `null` as the whole body of an embedded/multi-parameter body is a validation error. See `references/request-body.md`.
- **Breaking — defaults are not user input (`0.148.0`)**: defaults for omitted `Query`, `Header`, `Cookie`, and `Form` parameters and parameter-model fields are no longer validated unless `validate_default=True`, and applying a default no longer marks a field as explicitly set (`model_dump(exclude_unset=True)` excludes it). Default factories run once, validation errors no longer include injected defaults in `input`, and `Body(validate_default=True)` is honored.
- **Native OpenTelemetry (`0.142.0`)**: FastAPI emits HTTP request traces, metrics, and logs plus WebSocket traces and logs. Configure it with `FastAPI(telemetry={...})` (`tracing`, `metrics`, `logs`, `operation_spans`, `exclude`, provider injection). A failed automatic setup no longer aborts startup (`0.142.2`), tracers are cached so warnings deduplicate (`0.142.3`), and telemetry is isolated for excluded requests (`0.142.4`).
- **Parameter models grew (`0.157.0` – `0.159.1`)**: optional query/header/cookie parameter models (`0.159.0`), optional form models (`0.158.2`), optional unions of form models (`0.159.1`), combined query/header/cookie models (`0.157.0`), and combined form models (`0.158.0`).
- **Pydantic validation options on request parameters (`0.154.0`)**: `Query`, `Path`, `Header`, `Cookie`, `Body`, `Form`, and `File` accept Pydantic validation options such as `validate_default`.
- **WebSocket support in security dependencies (`0.144.0`)**: security schemes can now be used in WebSocket dependencies.
- **Header model error locations (`0.152.0`)**: validation errors for header parameter models report the HTTP header name (e.g. `int-val`) instead of the Python field name (`int_val`). Explicit aliases, `Header(convert_underscores=False)`, and `loc_by_alias=False` are unchanged.
- **Alias and metadata fixes (`0.156.0` – `0.156.7`)**: `AliasChoices` now works for query/header/cookie (`0.156.3`), path (`0.156.5`), named JSON body parameters, and form model extraction (`0.156.4`); form/file `AliasChoices` report correct error locations (`0.156.7`); model alias settings are respected for query/header/cookie parameters (`0.156.6`); Pydantic `Field()` attributes and field metadata survive into inferred request parameters (`0.156.0` – `0.156.2`).
- **Other fixes (`0.143.1` – `0.143.5`, `0.158.1`, `0.156.8`)**: form media types are preserved in the generated OpenAPI (`0.158.1`); uploaded file positions are preserved when converting to `bytes` (`0.156.8`); `byte` file list parameters handle empty values (`0.143.5`); non-finite float serialization is fixed for JSONL and SSE streams (`0.143.3`); blocking frontend fallback file checks are fixed (`0.143.2`); included route metadata is fixed in `iter_route_contexts()` (`0.143.1`); repeated endpoint wrapping in included routers is fixed (`0.142.1`); `httpx2` was added to the optional dependencies (`0.143.4`).
## Release Highlights (0.139.2 -> 0.141.1)
- **Frontend dev experience (`0.141.0`)**: `check_dir` on `app.frontend()` now defaults to `"auto"`, which skips the frontend-directory existence check (with a warning) when `FASTAPI_ENV=development` and enforces it otherwise. `fastapi dev` sets `FASTAPI_ENV=development` automatically unless already set, so running the dev server before the frontend is built no longer raises an error.
- **Frontend fixes (`0.141.1`)**: background tasks and response headers produced by dependencies used on frontend routes (dependency support was added in `0.139.0`) are now applied correctly instead of being silently dropped. `FASTAPI_ENV` is documented in the FastAPI CLI guide.
- **Dependency-injection memory refactor (`0.140.0` – `0.140.7`)**: internal dependency trees are no longer repeatedly flattened for OpenAPI generation, request-parameter resolution, and body-field handling, reducing memory use in large applications; the internal `lru_cache` limit for dependency resolution was also raised to fit bigger apps. This is an internal optimization with no required code changes.
- **Streaming fixes (`0.140.8` – `0.140.13`)**: `include_router()` no longer loses the declared stream item type from a nested router's `yield`-based endpoints; `response_model_*` params (e.g. `response_model_exclude`) are now honored on plain (non-generator) endpoints that `return` an `Iterable[Model]`, not only on `yield`-based ones; `status_code` set on SSE/JSONL streaming endpoints is now honored instead of always returning 200; a dedicated API reference page for `fastapi.sse` was added.
- **`jsonable_encoder` fix (`0.140.9`)**: `exclude_defaults` now propagates into dict keys and values, not only into top-level model fields.
## Release Highlights (0.137.0 -> 0.139.2)
- **Frontend serving (`0.138.0`)**: `app.frontend("/", directory="dist")` serves a built static frontend directly from the FastAPI app. `0.139.0` adds dependencies support in `app.frontend()`, enabling automatic cookie authentication for frontends, and `0.139.1` fixes fallback for dotted paths like `/users/john.doe`.
- **Router internals (`0.137.0`)**: `include_router()` now preserves `APIRouter`/`APIRoute` instances instead of cloning routes, so routes added after inclusion are reflected automatically and memory use drops. Custom `APIRouter`/`APIRoute` subclasses gain `.matches()`/`.handle()` (alpha) for advanced routing.
- **Thread safety (`0.139.2`)**: route building is refactored to be thread-safe, mainly relevant for tests running across parallel threads.
## Release Highlights (0.133.0 → 0.136.1)
- **0.134.0:** streaming JSON Lines and streaming binary data support using `yield`.
- **0.135.0:** first-class Server-Sent Events (SSE) support (`EventSourceResponse`).
- **0.135.1:** fix around `TaskGroup` usage in request async exit stack (stability fix).
- **0.136.1:** FastAPI updates its Pydantic v2 code to avoid deprecations and bumps Starlette to `1.0.0`.
## Patch Notes (0.136.2 → 0.136.3)
- SSE responses now validate event fields more strictly, so malformed `ServerSentEvent` payloads fail earlier instead of quietly streaming invalid frames.
- Header parameters no longer accept underscore-named incoming headers when `convert_underscores=True` (the default). If a client truly sends underscore headers, declare `Header(convert_underscores=False)` and verify that your proxy chain allows them.
## Quick Start
```python
from fastapi import FastAPI
app = FastAPI()
@app.get("/")
def read_root():
return {"Hello": "World"}
@app.get("/items/{item_id}")
def read_item(item_id: int, q: str | None = None):
return {"item_id": item_id, "q": q}
```
Run: `fastapi dev main.py`
## Core Patterns
### Type-Safe Parameters
```python
from typing import Annotated
from fastapi import Path, Query
@app.get("/items/{item_id}")
def read_item(
item_id: Annotated[int, Path(ge=1)],
q: Annotated[str | None, Query(max_length=50)] = None
):
return {"item_id": item_id, "q": q}
```
### Request Body with Validation
```python
from pydantic import BaseModel, Field
class Item(BaseModel):
name: str = Field(min_length=1, max_length=100)
price: float = Field(gt=0)
@app.post("/items/", response_model=Item)
def create_item(item: Item):
return item
```
### Dependencies
```python
from fastapi import Depends
async def get_db():
db = SessionLocal()
try:
yield db
finally:
db.close()
@app.get("/users/")
def list_users(db: Annotated[Session, Depends(get_db)]):
return db.query(User).all()
```
### Authentication
```python
from fastapi.security import OAuth2PasswordBearer
oauth2_scheme = OAuth2PasswordBearer(tokenUrl="token")
async def get_current_user(token: Annotated[str, Depends(oauth2_scheme)]):
return decode_token(token)
@app.get("/users/me")
def read_me(user: Annotated[User, Depends(get_current_user)]):
return user
```
## API Documentation
- Swagger UI: `/docs`
- ReDoc: `/redoc`
- OpenAPI: `/openapi.json`
## Best Practices
- Use `Annotated[Type, ...]` for parameters
- Define Pydantic models for request/response
- Use `response_model` for output filtering
- Add `status_code` for proper HTTP codes
- Use `tags` for API organization
- Add `dependencies` at router/app level for auth
## Prohibitions
- ❌ Return raw database models (use response models)
- ❌ Store passwords in plain text (use bcrypt/passlib)
- ❌ Mix `Body` with `Form`/`File` in same endpoint
- ❌ Use sync blocking I/O in async endpoints
- ❌ Skip HTTPException for error handling
## Links
- [Documentation](https://fastapi.tiangolo.com/)
- [Release Notes](https://fastapi.tiangolo.com/release-notes/)
- [Releases](https://github.com/fastapi/fastapi/releases)
- [GitHub](https://github.com/fastapi/fastapi)
- [PyPI](https://pypi.org/project/fastapi/)
© itechmeat · MIT · itechmeat/llm-code
Похожие скиллы
Все скиллы по теме «Бэкенд и API» →Сначала — fastapi от других авторов.