# python

Скилл для бэкенда на Python: типизация, asyncio, проверка ввода и тесты на pytest. Агент сначала пишет падающий тест, потом код.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 229 установок · ★ 48 у репозитория
- Автор: martinholovsky
- Лицензия: Unlicense · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/martinholovsky/claude-skills-generator/tree/HEAD/skills/python/SKILL.md
- Обновлён: 2025-12-06
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/martinholovsky-python

## Что делает

Скилл задаёт агенту роль бэкенд-разработчика на Python: аннотации типов, асинхронность, валидация ввода, тесты. Работа идёт по TDD — сначала падающий тест на pytest, потом минимальная реализация, затем рефакторинг. Проверка перед сдачей: `pytest --cov`, `mypy --strict`, `bandit -r src/ -ll`, `pip-audit` и `safety check`.

Внутри есть таблица решений на типовые случаи: пользовательский ввод через Pydantic, запросы к базе только параметризованные, подпроцессы со списком аргументов вместо `shell=True`, секреты из окружения. Отдельно разобраны приёмы производительности: `asyncio.gather` вместо последовательных запросов, генераторы на больших файлах, пул соединений SQLAlchemy, пакетные вставки.

Скилл помечен как HIGH-RISK, поэтому материал разложен по файлам: принципы в `SKILL.md`, разбор CVE и OWASP в `references/security-examples.md`, продвинутые паттерны и модель угроз отдельно. Агенту по умолчанию достаётся только `SKILL.md`, так что за деталями уязвимости нужный файл из `references/` придётся подложить самому. Примеры прогнаны на Python 3.11+, минимум поддержки 3.9.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill python -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/python/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/python/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill python -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/python/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill python -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/python/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install martinholovsky/claude-skills-generator skills/python
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/python/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill python -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/martinholovsky/claude-skills-generator --path skills/python
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/python/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill python -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/martinholovsky/claude-skills-generator/tree/HEAD/skills/python/SKILL.md

## Когда брать
- Написать падающий тест на pytest раньше самой реализации
- Убрать `shell=True` из вызова подпроцесса с пользовательскими данными
- Перевести последовательные HTTP-запросы на `asyncio.gather`
- Прочитать большой файл построчно через генератор, без загрузки в память
- Добавить `mypy --strict` и `bandit` в проверку перед коммитом

## Примеры запросов агенту
- Сделай эндпоинт `GET /users/{user_id}` на FastAPI: сначала тест, потом код.
- Проверь этот модуль на невалидированный ввод и SQL, собранный из строк.
- Перепиши загрузку логов на генератор, файл большой.

## Похожие
- [python-pro](https://affpapa.org/nevibecode/agents/voltagent-community-python-pro.md) — субагент · 11689 установок
- [async-python-patterns](https://affpapa.org/nevibecode/skills/async-python-patterns.md) — скилл · 18055 установок
- [python-patterns](https://affpapa.org/nevibecode/skills/python-patterns.md) — скилл · 1135 установок
- [python-backend](https://affpapa.org/nevibecode/skills/orchestkit-python-backend.md) — скилл · 250 установок
- [python-backend-expert](https://affpapa.org/nevibecode/skills/python-backend-expert.md) — скилл · 138 установок
- [python-expert](https://affpapa.org/nevibecode/agents/0xfurai-python-expert.md) — субагент · ★ 1029 у репозитория

## Другие версии с тем же именем
- [python · mindrally](https://affpapa.org/nevibecode/skills/python.md) — 1100 установок
- [python · alinaqi](https://affpapa.org/nevibecode/skills/alinaqi-python.md) — 282 установки
- [python · pproenca](https://affpapa.org/nevibecode/skills/pproenca-python.md) — 329 установок
- [python · siviter-xyz](https://affpapa.org/nevibecode/skills/siviter-xyz-python.md) — 353 установки
- [python · finom](https://affpapa.org/nevibecode/skills/finom-python.md) — ★ 57 у репозитория

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
