К основному содержанию
скилл CX Codex

fastapi-expert · personamanagmentlayer — скилл для Claude Code: что делает и как установить

Скилл fastapi-expert для разработки API на FastAPI: модели Pydantic, JWT-авторизация, SQLAlchemy и фоновые задачи с готовыми примерами кода.

Apache-2.0 218 установок ★ 45 обновлён 2026-10-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add personamanagmentlayer/pcl --skill fastapi-expert -a claude-code
Открыть на GitHub

Что делает fastapi-expert

Скилл даёт справочные сниппеты по FastAPI: базовое приложение с роутами и Pydantic-моделями, dependency injection для базы данных и аутентификации, JWT-токены через jose и хеширование паролей через passlib. Отдельно разобраны интеграция с SQLAlchemy (AsyncSession, CRUD-операции), валидация запросов через validator и фоновые задачи BackgroundTasks.

Активируется, когда в задаче упоминаются Python, API, async, REST, OpenAPI или Pydantic. Код в примерах рассчитан на асинхронный стек: AsyncSession из SQLAlchemy, asyncpg для PostgreSQL и uvicorn как сервер. Для запуска нужен Python и установленные зависимости из примеров — скилл сам их не ставит, только показывает, как их использовать.

Какие задачи решает

  • собрать CRUD-роуты с Pydantic-моделями запроса и ответа
  • настроить JWT-авторизацию с хешированием паролей
  • подключить SQLAlchemy с асинхронной сессией
  • вынести проверку токена и доступ к базе в зависимости FastAPI
  • добавить фоновую отправку письма после запроса

Примеры запросов агенту

  • Напиши роут /users с Pydantic-моделями UserCreate и UserResponse
  • Добавь JWT-авторизацию с OAuth2PasswordBearer и зависимостью get_current_user
  • Настрой асинхронное подключение к PostgreSQL через SQLAlchemy для FastAPI

Как установить fastapi-expert

1Через Skills CLI (Vercel)

npx skills add personamanagmentlayer/pcl --skill fastapi-expert -a claude-code

2Вручную: положить файлы

~/.claude/skills/fastapi-expert/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/fastapi-expert/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о fastapi-expert

Как установить fastapi-expert в Claude Code?

Выполните npx skills add personamanagmentlayer/pcl --skill fastapi-expert -a claude-code, после чего скилл появится в ~/.claude/skills/fastapi-expert/SKILL.md.

Что делает скилл fastapi-expert?

Он подсказывает, как собрать FastAPI-приложение: роуты с Pydantic-моделями, JWT-аутентификацию, подключение SQLAlchemy и фоновые задачи. Срабатывает при упоминании Python, API, async, REST, OpenAPI или Pydantic.

Какой стек подразумевают примеры fastapi-expert?

Асинхронный: AsyncSession из SQLAlchemy, asyncpg для PostgreSQL, jose для JWT, passlib для хеширования паролей и uvicorn как сервер.

Исходный текст

SKILL.md · Apache-2.0
---
name: fastapi-expert
version: 1.1.0
description: >-
  Expert-level FastAPI development for high-performance Python APIs with async support. Use
  when the user mentions Python, API, async, REST, OpenAPI, or Pydantic, or when the task
  involves FastAPI Features.
category: api
tags: [fastapi, python, api, async, rest, openapi, pydantic]
allowed-tools:
  - Read
  - Write
  - Edit
  - Bash(python:*, pip:*, uvicorn:*)
---

# FastAPI Expert

Expert guidance for FastAPI - modern, fast Python web framework for building APIs with automatic OpenAPI documentation and type safety.

## Core Concepts

### FastAPI Features

- Fast performance (Starlette + Pydantic)
- Automatic OpenAPI/Swagger docs
- Type hints and validation
- Async/await support
- Dependency injection
- OAuth2 and JWT
- WebSocket support

### Key Components

- Path operations (routes)
- Request/response models (Pydantic)
- Dependency injection
- Middleware
- Background tasks
- Testing with TestClient

## Basic FastAPI Application

```python
from fastapi import FastAPI, HTTPException, Depends
from pydantic import BaseModel, EmailStr, Field
from typing import List, Optional
import uvicorn

app = FastAPI(
    title="My API",
    description="Production-ready FastAPI",
    version="1.0.0"
)

# Models
class UserCreate(BaseModel):
    email: EmailStr
    name: str = Field(..., min_length=2, max_length=100)
    age: Optional[int] = Field(None, ge=0, le=150)

class UserResponse(BaseModel):
    id: int
    email: str
    name: str

    class Config:
        from_attributes = True

# Routes
@app.post("/users", response_model=UserResponse, status_code=201)
async def create_user(user: UserCreate):
    # Create user in database
    db_user = await db.users.create(**user.dict())
    return db_user

@app.get("/users/{user_id}", response_model=UserResponse)
async def get_user(user_id: int):
    user = await db.users.get(user_id)
    if not user:
        raise HTTPException(status_code=404, detail="User not found")
    return user

@app.get("/users", response_model=List[UserResponse])
async def list_users(skip: int = 0, limit: int = 100):
    return await db.users.find_many(skip=skip, limit=limit)

if __name__ == "__main__":
    uvicorn.run(app, host="0.0.0.0", port=8000)
```

## Dependency Injection

```python
from fastapi import Depends, HTTPException, status
from fastapi.security import OAuth2PasswordBearer
from sqlalchemy.ext.asyncio import AsyncSession

# Database dependency
async def get_db() -> AsyncSession:
    async with async_session() as session:
        yield session

# Auth dependency
oauth2_scheme = OAuth2PasswordBearer(tokenUrl="token")

async def get_current_user(
    token: str = Depends(oauth2_scheme),
    db: AsyncSession = Depends(get_db)
):
    credentials_exception = HTTPException(
        status_code=status.HTTP_401_UNAUTHORIZED,
        detail="Could not validate credentials"
    )

    payload = jwt.decode(token, SECRET_KEY, algorithms=[ALGORITHM])
    user_id: int = payload.get("sub")
    if user_id is None:
        raise credentials_exception

    user = await db.get(User, user_id)
    if user is None:
        raise credentials_exception

    return user

# Use dependencies
@app.get("/me", response_model=UserResponse)
async def read_users_me(current_user: User = Depends(get_current_user)):
    return current_user

@app.post("/posts")
async def create_post(
    post: PostCreate,
    current_user: User = Depends(get_current_user),
    db: AsyncSession = Depends(get_db)
):
    db_post = Post(**post.dict(), user_id=current_user.id)
    db.add(db_post)
    await db.commit()
    return db_post
```

## Authentication

```python
from datetime import datetime, timedelta
from jose import JWTError, jwt
from passlib.context import CryptContext

pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")

def verify_password(plain_password: str, hashed_password: str) -> bool:
    return pwd_context.verify(plain_password, hashed_password)

def get_password_hash(password: str) -> str:
    return pwd_context.hash(password)

def create_access_token(data: dict, expires_delta: timedelta = None):
    to_encode = data.copy()
    expire = datetime.utcnow() + (expires_delta or timedelta(minutes=15))
    to_encode.update({"exp": expire})
    return jwt.encode(to_encode, SECRET_KEY, algorithm=ALGORITHM)

@app.post("/token")
async def login(
    form_data: OAuth2PasswordRequestForm = Depends(),
    db: AsyncSession = Depends(get_db)
):
    user = await authenticate_user(db, form_data.username, form_data.password)
    if not user:
        raise HTTPException(status_code=401, detail="Invalid credentials")

    access_token = create_access_token(data={"sub": str(user.id)})
    return {"access_token": access_token, "token_type": "bearer"}
```

## Database Integration (SQLAlchemy)

```python
from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine
from sqlalchemy.orm import sessionmaker, declarative_base
from sqlalchemy import Column, Integer, String, Boolean

DATABASE_URL = "postgresql+asyncpg://user:password@localhost/dbname"

engine = create_async_engine(DATABASE_URL, echo=True)
async_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)

Base = declarative_base()

class User(Base):
    __tablename__ = "users"

    id = Column(Integer, primary_key=True, index=True)
    email = Column(String, unique=True, index=True, nullable=False)
    hashed_password = Column(String, nullable=False)
    is_active = Column(Boolean, default=True)

# CRUD operations
async def get_user(db: AsyncSession, user_id: int):
    return await db.get(User, user_id)

async def create_user(db: AsyncSession, user: UserCreate):
    hashed_password = get_password_hash(user.password)
    db_user = User(email=user.email, hashed_password=hashed_password)
    db.add(db_user)
    await db.commit()
    await db.refresh(db_user)
    return db_user
```

## Request Validation

```python
from pydantic import BaseModel, validator, root_validator
from typing import Optional
from datetime import date

class PostCreate(BaseModel):
    title: str = Field(..., min_length=5, max_length=200)
    content: str = Field(..., min_length=10)
    published: bool = False
    tags: List[str] = Field(default_factory=list, max_items=10)

    @validator('tags')
    def validate_tags(cls, v):
        return [tag.lower().strip() for tag in v]

    @validator('title')
    def validate_title(cls, v):
        if any(word in v.lower() for word in ['spam', 'xxx']):
            raise ValueError('Invalid content')
        return v
```

## Background Tasks

```python
from fastapi import BackgroundTasks

def send_email(email: str, message: str):
    # Send email
    print(f"Sending email to {email}: {message}")

@app.post("/send-notification")
async def send_notification(
    email: str,
    background_tasks: BackgroundTasks
):
    background_tasks.add_task(send_email, email, "Welcome!")
    return {"message": "Notification sent"}
```

## Testing

```python
from fastapi.testclient import TestClient
import pytest

client = TestClient(app)

def test_create_user():
    response = client.post(
        "/users",
        json={"email": "[email protected]", "name": "Test User"}
    )
    assert response.status_code == 201
    assert response.json()["email"] == "[email protected]"

def test_get_user():
    response = client.get("/users/1")
    assert response.status_code == 200
    assert "email" in response.json()

@pytest.mark.asyncio
async def test_async_endpoint():
    async with AsyncClient(app=app, base_url="http://test") as ac:
        response = await ac.get("/users")
    assert response.status_code == 200
```

## Best Practices

- Use Pydantic models for validation
- Implement proper error handling
- Use dependency injection
- Add rate limiting
- Enable CORS properly
- Use async/await for I/O
- Document with docstrings
- Add proper logging

## Resources

- FastAPI Docs: https://fastapi.tiangolo.com/
- Pydantic: https://docs.pydantic.dev/
- Starlette: https://www.starlette.io/

© personamanagmentlayer · Apache-2.0 · personamanagmentlayer/pcl

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →

Сначала — fastapi-expert от других авторов.

fastapi-expert https://github.com/Jeffallan Скилл fastapi-expert для Claude Code помогает разрабатывать асинхронные API на FastAPI с моделями Pydantic V2. Охватывает маршруты, аутентификацию, работу с базой и тесты. CX Codex +1 6 600установок fastapi-expert martinholovsky Скилл fastapi-expert настраивает агента на разработку асинхронных API на FastAPI с валидацией Pydantic v2, базой через SQLAlchemy 2.0 и тестами через pytest. CX Codex +1 267установок fastapi-python Mindrally Скилл fastapi-python для Claude Code, Codex, Cursor и других платформ: эксперт по FastAPI и асинхронному Python. Включается при разработке REST API, валидации через Pydantic и оптимизации производительности. CX Codex +1 14 100установок FastAPI pluginagentmarketplace Помогает писать API на Python с FastAPI: маршруты, модели Pydantic, async-обработчики, OAuth2 и тесты. CX Codex +1 181установок fastapi-microservices-development manutej Скилл fastapi-microservices-development помогает проектировать микросервисы на FastAPI, настраивать внедрение зависимостей и выстраивать асинхронное взаимодействие между сервисами. CX Codex +1 591установок FastAPI Customer Support Tech Enablement manutej Скилл FastAPI Customer Support Tech Enablement помогает агенту проектировать бэкенды на FastAPI для служб поддержки: тикеты, авторизацию операторов и подключение баз данных. CX Codex +1 424установок openapi-to-application-python-fastapi официальный Awesome Copilot Community Плагин openapi-to-application-python-fastapi для GitHub Copilot генерирует FastAPI-приложение по спецификации OpenAPI: каркас проекта, маршруты и зависимости. Создаёт асинхронные API на Python. ★ 41 430звёзд репо fastapi-endpoint davila7 Скилл fastapi-endpoint для Claude Code сначала опрашивает разработчика, затем проектирует и пишет асинхронные эндпоинты FastAPI со схемами Pydantic v2, SQLAlchemy 2.0 и тестами на pytest. CX Codex +1 393установок

Из того же набора104

Весь набор →
flask-expert Скилл flask-expert для Claude Code помогает разрабатывать Flask-приложения, REST API и серверную часть на Python. Охватывает маршруты, Jinja2, расширения и подготовку к продакшену. CX Codex +1 225установок csharp-expert Скилл csharp-expert для Claude Code помогает писать и разбирать современный C# для .NET, ASP.NET Core и корпоративных приложений. Работает с async-кодом, LINQ и типовыми архитектурными решениями. CX Codex +1 221установок maritime-expert Скилл maritime-expert для Claude Code даёт агенту знания о морских системах, судах, портах и грузах. Помогает проектировать логистическое и портовое ПО. CX Codex +1 221установок kafka-expert Скилл kafka-expert для Apache Kafka: продюсеры, консьюмеры, Kafka Streams и партиционирование — пригодится, когда в проекте появляется событийная шина. CX Codex +1 220установок nodejs-expert Скилл nodejs-expert направляет агента в разработке бэкенда на Node.js: учит настраивать Express, валидацию через Joi или Zod, обработку ошибок и кластеризацию. CX Codex +1 216установок databricks-expert Скилл databricks-expert для Claude Code подключает агенту практики Databricks: кластеры, Delta Lake, PySpark и MLflow. Разбирает медленные пайплайны и сбои на join. CX Codex +1 215установок kubernetes-expert Скилл kubernetes-expert помогает управлять кластерами Kubernetes, писать манифесты, дебажить поды через kubectl и собирать чарты Helm. Пригодится при настройке инфраструктуры. CX Codex +1 215установок spring-boot-expert Скилл spring-boot-expert помогает проектировать микросервисы, писать REST API на Spring Boot и настраивать работу с базами через Spring Data JPA. CX Codex +1 212установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой