# Type Hints

Скилл Type Hints учит агента писать аннотированный Python и настраивать mypy: от подписей функций до Protocol, TypedDict и строгого режима.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 128 установок · ★ 7 у репозитория
- Автор: pluginagentmarketplace
- Лицензия: LicenseRef-Proprietary · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/pluginagentmarketplace/custom-plugin-python/tree/HEAD/skills/type-hints/SKILL.md
- Обновлён: 2026-01-05
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/type-hints

## Что делает

Скилл разбирает аннотации типов в Python: переменные, сигнатуры функций, возвращаемые значения, Optional и Union. Дальше идёт продвинутая часть — дженерики, TypeVar, ParamSpec, Protocol, Literal, TypedDict.

Проверка вынесена отдельно: конфиг mypy, строгий режим, комментарии `# type: ignore`, стабы `.pyi`, покрытие типов. Есть блок про runtime: `typing_extensions`, валидация через Pydantic, типизированные dataclasses и attrs. Замыкают всё практики — постепенная типизация, сторонние стабы, проверка в CI.

Скилл привязан к субагенту `07-best-practices`, то есть материал ложится на ревью кода, а не на изучение синтаксиса с нуля. Нужны основы Python и ООП: на них держатся разделы про дженерики и структурную типизацию.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pluginagentmarketplace/custom-plugin-python skills/type-hints
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/pluginagentmarketplace/custom-plugin-python --path skills/type-hints
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a opencode
```

### Claude.ai

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

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

## Когда брать
- Расставить аннотации в старом модуле, не переписывая логику
- Включить строгий режим mypy и убрать протухшие `# type: ignore`
- Описать интерфейс через Protocol вместо базового класса
- Добавить проверку типов в CI
- Написать стабы для библиотеки, которая их не поставляет

## Примеры запросов агенту
- Пройди по `billing.py` и расставь аннотации типов у публичных функций.
- Почему mypy ругается на `Optional` в этом файле? Покажи, как исправить по строгому режиму.
- Замени этот `dict` на `TypedDict` и объясни, что поменяется.

## Похожие
- [Python Type Hints taste](https://affpapa.org/nevibecode/prompts/python-type-hints-taste.md) — промпт · ★ 178201 у репозитория
- [mypy](https://affpapa.org/nevibecode/skills/mypy.md) — скилл · 484 установки
- [typing-exclusion-worker](https://affpapa.org/nevibecode/skills/typing-exclusion-worker.md) — скилл · 1700 установок
- [ty-skills](https://affpapa.org/nevibecode/skills/ty-skills.md) — скилл · 133 установки
- [python-type-safety](https://affpapa.org/nevibecode/skills/python-type-safety.md) — скилл · 12643 установки
- [python-pro](https://affpapa.org/nevibecode/skills/httpsgithubcomjeffallan-python-pro.md) — скилл · 9300 установок

Из того же набора: [pluginagentmarketplace/custom-plugin-python](https://affpapa.org/nevibecode/by/pluginagentmarketplace/custom-plugin-python.md) — 12 карточек

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