# clean-code-ts-react

Скилл clean-code-ts-react переносит принципы Clean Code Роберта Мартина на TypeScript 5.x и React 19. Помогает на код-ревью, при рефакторинге и проектировании компонентов или функций.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 238 установок · ★ 227 у репозитория
- Автор: pproenca
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/pproenca/dot-skills/tree/HEAD/skills/.experimental/clean-code-ts-react/SKILL.md
- Обновлён: 2026-08-15
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/clean-code-ts-react

## Что делает

Скилл содержит 61 правило в 11 категориях: от именования переменных и декомпозиции функций до обработки ошибок и тестирования. Все правила упорядочены по когнитивной нагрузке при чтении и правке кода. Примеры опираются на синтаксис TypeScript 5.x (`satisfies`, дискриминированные объединения, брендированные типы) и React 19, но акцент сделан на архитектурных решениях, а не на синтаксисе фреймворка.

Главное отличие от обычных чеклистов — явные сценарии «когда правило применять не нужно». Например, счётчики циклов допустимо называть `i`, а единичный код не требует выноса по DRY. Отдельная категория посвящена конфликтам между принципами: где выбрать простоту вместо глубоких абстракций или балансировать между типобезопасностью и удобством вызова.

Для низкоуровневых API React вроде Server Components или оптимизации `tsconfig` этот скилл не подойдёт: автор прямо отправляет к отдельным скиллам `react` и `typescript`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill clean-code-ts-react -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill clean-code-ts-react -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill clean-code-ts-react -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pproenca/dot-skills skills/.experimental/clean-code-ts-react
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill clean-code-ts-react -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/pproenca/dot-skills --path skills/.experimental/clean-code-ts-react
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill clean-code-ts-react -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/pproenca/dot-skills/tree/HEAD/skills/.experimental/clean-code-ts-react/SKILL.md

## Когда брать
- провести ревью пуллреквеста на ясность имён и глубину абстракций
- разрешить противоречие между DRY и принципом единственной ответственности
- упростить длинные функции через декомпозицию и разделение команд и запросов
- выбрать подходящий способ обработки ошибок между исключениями и типом Result

## Примеры запросов агенту
- Проверь этот React-компонент на чистоту кода и читаемость названий
- Помоги отрефакторить эту TypeScript-функцию: разделены ли здесь команды и запросы?
- Оцени абстракцию в этом хуке: стоит ли выносить логику или код лучше оставить на месте?

## Похожие
- [typescript-clean-code](https://affpapa.org/nevibecode/skills/typescript-clean-code.md) — скилл · 669 установок
- [clean-code](https://affpapa.org/nevibecode/skills/sickn33-clean-code.md) — скилл · 13100 установок
- [clean-code-guard](https://affpapa.org/nevibecode/skills/clean-code-guard.md) — скилл · 4900 установок
- [narrow-react-prop-types](https://affpapa.org/nevibecode/skills/narrow-react-prop-types.md) — скилл · 1500 установок
- [clean-code-principles](https://affpapa.org/nevibecode/skills/clean-code-principles.md) — скилл · 1900 установок
- [react-composition-2026](https://affpapa.org/nevibecode/skills/react-composition-2026.md) — скилл · 1200 установок

Из того же набора: [pproenca/dot-skills](https://affpapa.org/nevibecode/by/pproenca/dot-skills.md) — 139 карточек

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

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