dotfile-audit — скилл для Claude Code: что делает и как установить
Проверяет и исправляет DOT-файлы конвейеров перед запуском. Находит тупиковые узлы, ошибки условий и пропущенные шаги из спецификации.
npx skills add harperreed/dotfiles --skill dot-file-audit -a claude-codeЧто делает dotfile-audit
Скилл анализирует графы DOT, по которым агентные конвейеры генерируют код. Он проверяет базовую структуру графа: наличие ровно одной точки старта shape=Mdiamond и одного выхода shape=Msquare, корректность глобальных настроек вроде goal и retry_target, а также баланс параллельных веток. Выдуманные атрибуты вроде join_policy удаляются сразу.
Если к проекту приложен документ с требованиями, аудит сверяет граф со спецификацией. Для каждого компонента он требует звенья сборки, проверки и фиксации изменений через коммиты. Ошибки здесь критичны: движок откажется исполнять граф с предупреждениями утилиты dotfile validate <file>.dot. Скилл правит файл по кругу до нулевого остатка проблем.
Какие задачи решает
- исправить синтаксис и структуру DOT-графа конвейера
- настроить ветки обработки ошибок для узлов кодогенерации
- сверить этапы графа с техническим заданием проекта
- устранить предупреждения утилиты
dotfile validate
Примеры запросов агенту
- Проверь файл pipeline.dot и устрани все предупреждения валидатора
- Сверь граф workflow.dot со спецификацией spec.md и добавь недостающие тесты
- Найди в architecture.dot узлы без путей отката при сбоях
Как установить dotfile-audit
1Через Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill dot-file-audit -a claude-code2Вручную: положить файлы
~/.claude/skills/dot-file-audit/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/dot-file-audit/
1Через Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill dot-file-audit -a codex2Вручную: положить файлы
.agents/skills/dot-file-audit/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill dot-file-audit -a cursor2Вручную: положить файлы
.cursor/skills/dot-file-audit/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install harperreed/dotfiles dot-file-audit2Вручную: положить файлы
.github/skills/dot-file-audit/SKILL.md1Через Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill dot-file-audit -a gemini-cli2Командой платформы
gemini skills install https://github.com/harperreed/dotfiles --path .claude/skills-archive/dot-file-auditВручную: положить файлы
.devin/skills/dot-file-audit/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill dot-file-audit -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о dotfile-audit
Как установить dotfile-audit в Claude Code?
Выполните команду npx skills add harperreed/dotfiles --skill dot-file-audit -a claude-code. Файл навыка сохранится в ~/.claude/skills/dot-file-audit/SKILL.md.
Зачем нужен скилл dotfile-audit?
Он автоматизирует аудит DOT-файлов перед запуском кодогенерации. Скилл находит пропущенные сценарии ошибок, неподдерживаемые атрибуты узлов и расхождения графа со спецификацией проекта.
Как скилл проверяет ветки сбоев в узлах?
Для каждого прямоугольного узла кодогенерации проверяется наличие флага goal_gate=true с целевым шагом перезапуска retry_target либо исходящее ребро с условием outcome=fail. Если пути нет, скилл добавляет нужные атрибуты.
