# mastering-typescript

Помогает писать строгий код на TypeScript 5.9+ и настраивать тулчейн для React 19 или NestJS 11. Пригодится при миграции с JavaScript и проектировании сложных типов.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 790 установок · ★ 31
- Автор: Richard Hightower
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/SpillwaveSolutions/mastering-typescript-skill/tree/HEAD/mastering-typescript/SKILL.md
- Обновлён: 2026-01-01
- HTML: https://affpapa.org/nevibecode/skills/mastering-typescript

## Что делает

Скилл направляет агента при разработке на TypeScript 5.9+, предлагая строгие конфигурации компилятора и типобезопасные шаблоны. Внутри собраны правила для `tsconfig.json` с включёнными флагами `noUncheckedIndexedAccess` и `exactOptionalPropertyTypes`, чеклист запуска проектов на pnpm, а также примеры работы с оператором `satisfies` и размеченными объединениями.

Инструкции описывают интеграцию с React 19 и NestJS 11. Отдельные разделы посвящены валидации через Zod и проверкам в Vitest. Скилл также помогает сравнивать подходы TypeScript с паттернами из Java и Python при переносе архитектуры.

Ориентация строго на TypeScript 5.9+ и Node.js 22 LTS сразу отсекает старые проекты. Если применить предложенные флаги сборки на устаревшем компиляторе, среда выдаст ошибки конфигурации.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add SpillwaveSolutions/mastering-typescript-skill --skill mastering-typescript -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add SpillwaveSolutions/mastering-typescript-skill --skill mastering-typescript -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add SpillwaveSolutions/mastering-typescript-skill --skill mastering-typescript -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install SpillwaveSolutions/mastering-typescript-skill mastering-typescript
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add SpillwaveSolutions/mastering-typescript-skill --skill mastering-typescript -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/SpillwaveSolutions/mastering-typescript-skill --path mastering-typescript
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add SpillwaveSolutions/mastering-typescript-skill --skill mastering-typescript -a opencode
```

### Claude.ai

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

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

## Когда брать
- Настроить строгий `tsconfig.json` с поддержкой ESM и современных флагов компилятора
- Реализовать сужение типов и проверку структур через оператор `satisfies`
- Спроектировать типобезопасные контракты API с валидацией через Zod
- Интегрировать TypeScript 5.9+ с React 19, NestJS 11 или LangChain.js
- Перевести существующую кодовую базу с чистого JavaScript на TypeScript

## Примеры запросов агенту
- Помоги настроить tsconfig.json для Vite и pnpm с максимальной строгостью типов
- Покажи, как использовать оператор satisfies вместо as для конфигурационного объекта
- Напиши типизированный обработчик API с валидацией через Zod и раздельными типами результата

## Похожие
- [typescript-refactor](https://affpapa.org/nevibecode/skills/typescript-refactor.md) — скилл · 788 установок
- [typescript-write](https://affpapa.org/nevibecode/skills/typescript-write.md) — скилл · 2100 установок
- [typescript-variables](https://affpapa.org/nevibecode/skills/typescript-variables.md) — скилл · 3800 установок
- [typescript-pro](https://affpapa.org/nevibecode/agents/voltagent-community-typescript-pro.md) — субагент · 9602 установки
- [typescript-magician](https://affpapa.org/nevibecode/skills/typescript-magician.md) — скилл · 2800 установок
- [typescript-advanced-types](https://affpapa.org/nevibecode/skills/sickn33-typescript-advanced-types.md) — скилл · 1300 установок

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

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