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

ty-skills — скилл для Claude Code: что делает и как установить

Скилл ty-skills обучает ассистента проверять типы в Python через утилиту ty от Astral, настраивать правила и переносить проекты с mypy.

MIT 133 установок ★ 10 обновлён 2026-01-25

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

Что делает ty-skills

Скилл даёт ассистенту инструкции по работе с быстрым тайпчекером ty от Astral. Внутри собраны справочники по правилам проверки, типичным ошибкам и расширенным паттернам Python: протоколам, дженерикам и типам пересечений (intersection types).

В состав входят руководства по миграции с mypy или pyright, шпаргалка по модулю typing и примеры настройки редакторов вроде Cursor или VS Code. Скилл также объясняет синтаксис подавления ошибок через # type: ignore[...] и параметры секций pyproject.toml.

Сам скилл не содержит исполняемый бинарник: для запуска проверок утилиту ty нужно ставить отдельно через uv tool install ty или pip install ty.

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

  • Настроить проверку типов в pyproject.toml для проекта на Python
  • Исправить ошибки invalid-argument-type и possibly-unresolved-reference
  • Перенести кодовую базу с mypy или pyright на ty
  • Задать типы пересечений и протоколы в сложных сигнатурах

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

  • Помоги перевести проект с mypy на ty и настрой секцию [tool.ty.rules] в pyproject.toml.
  • Объясни ошибку possibly-unresolved-reference в функции parse_data и исправь её.
  • Как в ty объявить тип пересечения для объекта, реализующего два протокола?

Как установить ty-skills

1Через Skills CLI (Vercel)

npx skills add jiatastic/open-python-skills --skill ty-skills -a claude-code

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

~/.claude/skills/ty-skills/SKILL.md

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

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

Вопросы о ty-skills

Как установить ty-skills в Claude Code?

Выполните команду npx skills add jiatastic/open-python-skills --skill ty-skills -a claude-code.

Что делает ty-skills?

Он учит языковую модель проверять типы в Python с помощью чекера ty от Astral, разбирать его диагностику и настраивать правила проекта.

Нужен ли установленный ty для работы скилла?

Да, скилл даёт инструкции ассистенту, но саму проверку кода выполняет утилита ty, которую нужно установить в систему через uv или pip.

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

SKILL.md · MIT
---
name: ty-skills
description: >
  Python type checking expertise using ty - the extremely fast type checker by Astral.
  Use when: (1) Adding type annotations to Python code, (2) Fixing type errors reported by ty,
  (3) Migrating from mypy/pyright to ty, (4) Configuring ty for projects,
  (5) Understanding advanced type patterns (generics, protocols, intersection types),
  (6) Setting up ty in editors (VS Code, Cursor, Neovim, PyCharm).
---

# ty-skills

Master Python type checking with [ty](https://docs.astral.sh/ty/) - the extremely fast type checker written in Rust by Astral (creators of uv and Ruff).

## When to Use This Skill

- Adding type annotations to Python code
- Fixing type errors and diagnostics from ty
- Configuring ty rules and severity levels
- Migrating from mypy or pyright to ty
- Understanding advanced type patterns (intersection types, protocols, generics)
- Setting up ty language server in your editor

## Quick Start

```bash
# Install
uv tool install ty
# or: pip install ty

# Check current directory
ty check

# Check specific files
ty check src/

# Full diagnostics
ty check --output-format full
```

## Configuration

Configure via `pyproject.toml`:

```toml
[tool.ty.environment]
python-version = "3.12"
python = "./.venv"
python-platform = "linux"
root = ["./src"]
extra-paths = ["./typings"]

[tool.ty.rules]
# error: fail CI, warn: report, ignore: disable
possibly-unresolved-reference = "error"
invalid-argument-type = "error"
division-by-zero = "warn"
unused-ignore-comment = "warn"

[tool.ty.src]
include = ["src", "tests"]
exclude = ["src/migrations/"]

# Per-file overrides
[[tool.ty.overrides]]
include = ["tests/**"]

[tool.ty.overrides.rules]
possibly-unresolved-reference = "warn"
```

## Rules Quick Reference

| Rule | Default | Description |
|------|---------|-------------|
| `possibly-unresolved-reference` | error | Variable might not be defined |
| `invalid-argument-type` | error | Argument type mismatch |
| `incompatible-assignment` | error | Assigned value incompatible |
| `missing-argument` | error | Required argument missing |
| `unsupported-operator` | error | Operator not supported for types |
| `invalid-return-type` | error | Return type mismatch |
| `division-by-zero` | warn | Potential division by zero |
| `unused-ignore-comment` | warn | Suppression not needed |
| `redundant-cast` | warn | Cast has no effect |
| `possibly-unbound-attribute` | warn | Attribute might not exist |
| `index-out-of-bounds` | warn | Index might be out of range |

## Intersection Types (ty Exclusive)

ty has first-class intersection type support:

```python
def output_as_json(obj: Serializable) -> str:
    if isinstance(obj, Versioned):
        reveal_type(obj)  # reveals: Serializable & Versioned
        return str({
            "data": obj.serialize_json(),  # From Serializable
            "version": obj.version          # From Versioned
        })
    return obj.serialize_json()
```

## Suppression Comments

```python
# Suppress single rule
x: int = "hello"  # type: ignore[incompatible-assignment]

# Suppress multiple
y = risky()  # type: ignore[possibly-unresolved-reference, invalid-argument-type]
```

## Reference Documents

For detailed information, see:

| Document | Content |
|----------|---------|
| `references/ty_rules_reference.md` | All rules with examples and fixes |
| `references/typing_cheatsheet.md` | Python typing module quick reference |
| `references/advanced_patterns.md` | Protocols, generics, type guards, variance |
| `references/migration_guide.md` | mypy/pyright → ty migration |
| `references/common_errors.md` | Error solutions with examples |
| `references/editor_setup/` | VS Code, Cursor, Neovim setup |

## Resources

- [ty Documentation](https://docs.astral.sh/ty/)
- [ty Playground](https://play.astral.sh/ty)
- [ty GitHub](https://github.com/astral-sh/ty)

© jiatastic · MIT · jiatastic/open-python-skills

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

Все скиллы по теме «Языки программирования» →
typing-exclusion-worker getsentry Скилл typing-exclusion-worker убирает модули Python из списка исключений mypy в pyproject.toml, чинит типы и проверяет код тестами. Пригодится при параллельном закрытии долга по типизации. CX Codex +1 1 700установок Type Hints pluginagentmarketplace Скилл Type Hints учит агента писать аннотированный Python и настраивать mypy: от подписей функций до Protocol, TypedDict и строгого режима. CX Codex +1 128установок python-code-quality laurigates Скилл python-code-quality для Claude Code и Codex координирует стек проверки качества Python-кода. Включается при вопросах о линтинге, форматировании, стиле и проверке типов через ruff и ty. CX Codex +1 1 100установок uv astral-sh Обучает агента управлять окружением и зависимостями через менеджер uv. Перехватывает задачи по скриптам, пакетам и проектам на Python. CX Codex +1 5 300установок ty astral-sh Подключает проверку типов Python через ty. Агент использует его при проверке Python-кода и настройке типизации проекта. CX Codex +1 3 300установок python-code-style Seth Hobson Скилл python-code-style для Claude Code задаёт правила стиля Python, линтеров, форматирования и документации для новых модулей, ревью и настройки проекта. CX Codex +1 16 456установок

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

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

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