# dx-review

Скилл dx-review анализирует публичный API библиотеки с точки зрения удобства для разработчиков. Находит шероховатости в типах TypeScript, сигнатурах методов и обработке ошибок.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 установка · ★ 1855 у репозитория
- Автор: LibPDF-js
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/LibPDF-js/core/tree/HEAD/.opencode/skills/dx-review/SKILL.md
- Обновлён: 2026-10-26
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/dx-review

## Что делает

Скилл оценивает интерфейс библиотеки глазами внешнего разработчика. Если область проверки не задана в диалоге, агент берёт основной публичный API и исследует имена методов, предсказуемость возвращаемых типов и дефолтные параметры. Анализ опирается на критерии читаемости, эргономики, полезности сообщений об ошибках, точности типов TypeScript, наличия JSDoc и соответствия стандартам платформы.

В процессе проверки агент изучает определения типов, отслеживает типовые пользовательские сценарии и ищет лишний шаблонный код. Итоговый отчёт скилл сохраняет в файл `.agents/scratch/dx-review-<scope>.md`. В отчёте каждая найденная проблема сопровождается уровнем критичности, категорией, примером неудобного вызова и кодом с рекомендацией по исправлению.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add LibPDF-js/core --skill dx-review -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add LibPDF-js/core --skill dx-review -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add LibPDF-js/core --skill dx-review -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install LibPDF-js/core .opencode/skills/dx-review
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add LibPDF-js/core --skill dx-review -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/LibPDF-js/core --path .opencode/skills/dx-review
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add LibPDF-js/core --skill dx-review -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/LibPDF-js/core/tree/HEAD/.opencode/skills/dx-review/SKILL.md

## Когда брать
- проверить эргономику и предсказуемость публичного API библиотеки
- выявить неточные типы TypeScript и пробелы в автодополнении
- найти лишний бойлерплейт в типичных сценариях вызова
- сформировать структурированный отчёт с примерами кода до и после правки

## Примеры запросов агенту
- Проверь DX основного публичного API библиотеки
- Оцени эргономику модуля работы с формами и сохрани отчёт
- Проанализируй типы TypeScript и удобство обработки ошибок в текущем API

## Похожие
- [public-api-design-review](https://affpapa.org/nevibecode/skills/public-api-design-review.md) — скилл · 10200 установок
- [plan-devex-review](https://affpapa.org/nevibecode/skills/plan-devex-review.md) — скилл · 378 установок
- [pit-of-success](https://affpapa.org/nevibecode/skills/pit-of-success.md) — скилл · 137 установок
- [api-review](https://affpapa.org/nevibecode/skills/api-review.md) — скилл · 4800 установок
- [api-design](https://affpapa.org/nevibecode/skills/margelo-api-design.md) — скилл · 1400 установок
- [design](https://affpapa.org/nevibecode/skills/rainmanjam-design.md) — скилл · ★ 26 у репозитория

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

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