Type Hints — скилл для Claude Code: что делает и как установить
Скилл Type Hints учит агента писать аннотированный Python и настраивать mypy: от подписей функций до Protocol, TypedDict и строгого режима.
LicenseRef-Proprietary 128 установок ★ 7 обновлён 2026-01-05
npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a claude-codeЧто делает 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 и ООП: на них держатся разделы про дженерики и структурную типизацию.
Какие задачи решает
- Расставить аннотации в старом модуле, не переписывая логику
- Включить строгий режим mypy и убрать протухшие
# type: ignore - Описать интерфейс через Protocol вместо базового класса
- Добавить проверку типов в CI
- Написать стабы для библиотеки, которая их не поставляет
Примеры запросов агенту
- Пройди по
billing.pyи расставь аннотации типов у публичных функций. - Почему mypy ругается на
Optionalв этом файле? Покажи, как исправить по строгому режиму. - Замени этот
dictнаTypedDictи объясни, что поменяется.
Как установить Type Hints
1Через Skills CLI (Vercel)
npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a claude-code2Вручную: положить файлы
~/.claude/skills/type-hints/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/type-hints/
1Через Skills CLI (Vercel)
npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a codex2Вручную: положить файлы
.agents/skills/type-hints/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a cursor2Вручную: положить файлы
.cursor/skills/type-hints/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install pluginagentmarketplace/custom-plugin-python skills/type-hints2Вручную: положить файлы
.github/skills/type-hints/SKILL.md1Через Skills CLI (Vercel)
npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a gemini-cli2Командой платформы
gemini skills install https://github.com/pluginagentmarketplace/custom-plugin-python --path skills/type-hintsВручную: положить файлы
.devin/skills/type-hints/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о Type Hints
Как установить Type Hints в Claude Code?
Выполните npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a claude-code. Файл скилла окажется по пути ~/.claude/skills/type-hints/SKILL.md.
Что делает Type Hints?
Проводит агента по аннотациям Python и статической проверке с mypy: базовые подписи, дженерики, Protocol, TypedDict, настройка mypy и типы в рантайме.
Что нужно знать до начала?
Основы Python и ООП. Разделы про TypeVar и структурную типизацию опираются на классы и интерфейсы, а не на синтаксис с нуля.