# design-debt-audit

Разбирает накопленные несоответствия в интерфейсе по категориям и выдаёт план правок с приоритетами. Нужен, когда продукт рос годами и дизайн поехал.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1700 установок · ★ 3103
- Автор: Owl-Listener
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/Owl-Listener/designer-skills/tree/HEAD/design-ops/skills/design-debt-audit/SKILL.md
- Обновлён: 2026-09-05
- HTML: https://affpapa.org/nevibecode/skills/design-debt-audit

## Что делает

Скилл проводит инвентаризацию дизайн-долга и раскладывает находки по пяти категориям: визуальные расхождения, структурные проблемы, нарушения доступности, пробелы в документации и долг реализации. Каждой находке присваивается серьёзность, частота и примерная трудоёмкость починки, а приоритет считается как серьёзность, умноженная на частоту и делённая на трудозатраты.

Работа идёт по шагам: сначала определяется охват (весь продукт, одна область или одна платформа), затем снимаются скриншоты всех экранов и состояний, потом идёт классификация и подсчёт. На выходе — короткий список первоочередных правок, быстрые победы вроде замены захардкоженных значений на токены и отдельный перечень задач под переработку. Отдельно ведётся живой реестр долга с владельцем, статусом и целевым сроком; его советуют пересматривать раз в квартал.

Скилл не заменяет точечные проверки. Для покрытия токенами есть `design-token-audit` из designer-toolkit, а для разрывов по WCAG — `accessibility-audit` из design-systems. Если нужен именно общий обзор накопленного разъезда, берите этот. Аудит — это исследование, а не спринт по исправлению, и оценку трудоёмкости лучше делать вместе с инженерами: дизайнеры часто недооценивают сложность реализации.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Owl-Listener/designer-skills --skill design-debt-audit -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Owl-Listener/designer-skills --skill design-debt-audit -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Owl-Listener/designer-skills --skill design-debt-audit -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Owl-Listener/designer-skills design-debt-audit
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Owl-Listener/designer-skills --skill design-debt-audit -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Owl-Listener/designer-skills --path design-ops/skills/design-debt-audit
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Owl-Listener/designer-skills --skill design-debt-audit -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Owl-Listener/designer-skills/tree/HEAD/design-ops/skills/design-debt-audit/SKILL.md

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

## Примеры запросов агенту
- проведи аудит дизайн-долга по всему продукту и расставь приоритеты
- собери расхождения между экранами и дизайн-системой, разложи по категориям
- составь реестр дизайн-долга с серьёзностью и трудоёмкостью починки

## Похожие
- [tailwind-design-system](https://affpapa.org/nevibecode/skills/sickn33-tailwind-design-system.md) — скилл · 1600 установок
- [design-better](https://affpapa.org/nevibecode/skills/design-better.md) — скилл · 1100 установок
- [ui-ux-design-pro](https://affpapa.org/nevibecode/skills/ui-ux-design-pro.md) — скилл · 797 установок
- [improve-ui](https://affpapa.org/nevibecode/skills/improve-ui.md) — скилл · 7900 установок
- [better-interface](https://affpapa.org/nevibecode/skills/better-interface.md) — скилл · 30000 установок
- [audit-ai-design-slop](https://affpapa.org/nevibecode/skills/audit-ai-design-slop.md) — скилл · 1200 установок

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

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