pydantic · jiatastic — скилл для Claude Code: что делает и как установить
Скилл объясняет агенту, как описывать данные моделями Pydantic: типизированные поля, валидаторы, сериализация и выгрузка JSON-схемы.
MIT 194 установок ★ 10 обновлён 2026-01-25
npx skills add jiatastic/open-python-skills --skill pydantic -a claude-codeЧто делает pydantic
Скилл закрывает повседневную работу с Pydantic: схемы на подсказках типов Python, проверка входящих и исходящих данных, выгрузка модели через model_dump() и model_dump_json(), JSON-схема для документации.
Внутри набор шаблонов: типизированные поля, field_validator для отдельных значений, проверки между полями, BaseSettings для конфига из переменных окружения. Отдельный раздел про model_validate() и частые сбои: неожиданное приведение типов, медленные валидаторы, изменяемые значения по умолчанию (там советуют default_factory).
Pydantic ставят в окружение проекта: uv pip install pydantic. Скилл — это инструкция, а не библиотека, поэтому без пакета он ничего не проверит. Строгие типы включают там, где приведение мешает: в скилле это отмечено как частая неожиданность.
Какие задачи решает
- описать схему запроса моделью Pydantic
- отсеять битый JSON до записи в базу
- выгрузить JSON-схему для документации API
- добавить проверку одного поля через
field_validator - читать настройки из переменных окружения через
BaseSettings
Примеры запросов агенту
- Опиши модель Pydantic для пользователя с полями id и email, имя не должно быть пустым.
- Прогони этот словарь через
model_validateи покажи результатmodel_dump(). - Собери JSON-схему из модели, чтобы вставить её в документацию.
Как установить pydantic
1Через Skills CLI (Vercel)
npx skills add jiatastic/open-python-skills --skill pydantic -a claude-code2Вручную: положить файлы
~/.claude/skills/pydantic/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/pydantic/
1Через Skills CLI (Vercel)
npx skills add jiatastic/open-python-skills --skill pydantic -a codex2Вручную: положить файлы
.agents/skills/pydantic/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jiatastic/open-python-skills --skill pydantic -a cursor2Вручную: положить файлы
.cursor/skills/pydantic/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jiatastic/open-python-skills skills/pydantic2Вручную: положить файлы
.github/skills/pydantic/SKILL.md1Через Skills CLI (Vercel)
npx skills add jiatastic/open-python-skills --skill pydantic -a gemini-cli2Командой платформы
gemini skills install https://github.com/jiatastic/open-python-skills --path skills/pydanticВручную: положить файлы
.devin/skills/pydantic/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jiatastic/open-python-skills --skill pydantic -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о pydantic
Как установить скилл pydantic в Claude Code?
Выполните npx skills add jiatastic/open-python-skills --skill pydantic -a claude-code. Файл скилла появится в ~/.claude/skills/pydantic/SKILL.md.
Что делает скилл pydantic?
Даёт агенту шаблоны моделей, валидаторов и сериализации Pydantic, чтобы он писал проверки данных по одному образцу, а не с нуля каждый раз.
Нужен ли сам Pydantic в проекте?
Да, пакет ставят отдельно: uv pip install pydantic. Скилл только подсказывает, как его использовать.
Исходный текст
SKILL.md · MIT
---
name: pydantic
description: >
Pydantic models and validation. Use when: (1) Defining schemas,
(2) Validating input/output, (3) Generating JSON schema.
---
# pydantic
Type-driven validation and serialization using Pydantic models.
## Overview
Pydantic validates data using Python type hints and provides rich serialization via `model_dump()` and JSON schema output.
## When to Use
- Validating request/response payloads
- Normalizing untrusted input
- Generating JSON schema for docs
## Quick Start
```bash
uv pip install pydantic
```
```python
from pydantic import BaseModel
class User(BaseModel):
id: int
email: str
user = User(id=1, email="[email protected]")
```
## Core Patterns
1. **Typed fields**: strict schema definitions.
2. **Field validators**: custom validation logic.
3. **Model validators**: cross-field checks.
4. **Serialization**: `model_dump()` and `model_dump_json()`.
5. **Settings**: environment-driven config via `BaseSettings`.
## Example: field_validator
```python
from pydantic import BaseModel, field_validator
class Model(BaseModel):
name: str
@field_validator("name")
@classmethod
def ensure_not_empty(cls, v: str):
if not v:
raise ValueError("name required")
return v
```
## Example: model_validate + model_dump
```python
from pydantic import BaseModel
class Model(BaseModel):
foo: int
model = Model.model_validate({"foo": 1})
print(model.model_dump())
```
## Troubleshooting
- **Coercion surprises**: use strict types if needed
- **Slow validators**: keep them minimal
- **Mutable defaults**: use `default_factory`
## References
- https://docs.pydantic.dev/
© jiatastic · MIT · jiatastic/open-python-skills
Похожие скиллы
Все скиллы по теме «Бэкенд и API» →Сначала — pydantic от других авторов.