principal-engineering — скилл для Claude Code: как установить
Скилл задаёт строгие инженерные правила перед правками: запрещает заглушать ошибки, требует чекпоинт рисков и проверку работы реальным кодом, а не догадками.
npx skills add riekelt/principal-engineer --skill principal-engineering -a claude-codeЧто делает principal-engineering
Скилл внедряет инженерную дисциплину перед любыми нетривиальными изменениями в кодовой базе, конфигурациях или базах данных. Перед началом работы агент обязан зафиксировать четыре вещи в рабочих заметках: что именно прочитано в коде, зону поражения (blast radius), инварианты и точную команду проверки. Это исключает исправления наугад.
Внутри зашиты жёсткие правила для всех репозиториев. Скилл блокирует скрытое проглатывание ошибок в блоках catch, запрещает редактировать уже применённые миграции БД, блокирует вывод секретов на диск и требует проверки глазами перед удалением данных. Жёсткость проверок зависит от уровня риска: критические денежные пути или пользовательские данные требуют инвариантных тестов, а для вспомогательных скриптов достаточно базового соблюдения запретов.
Инструкции проекта в CLAUDE.md и локальные соглашения о стиле всегда имеют приоритет над этим скиллом. Для глубокой проработки конкретных задач он направляет агента к дочерним навыкам: grounding-before-coding, handling-failures или verifying-before-done.
Какие задачи решает
- Остановить скрытое проглатывание исключений в блоках перехвата ошибок
- Зафиксировать инварианты и зону поражения до начала правок в коде
- Предотвратить редактирование уже применённых миграций базы данных
- Заставить агента подтверждать завершение задачи выводом реальных команд проверки
Примеры запросов агенту
- Проверь инварианты и составь чекпоинт перед рефакторингом модуля биллинга.
- Найди причину бага в авторизации, опираясь на логи и реальный код, а не на догадки.
- Подготовь миграцию для новой таблицы с учётом правил principal-engineering.
Как установить principal-engineering
1Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill principal-engineering -a claude-code2Вручную: положить файлы
~/.claude/skills/principal-engineering/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/principal-engineering/
1Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill principal-engineering -a codex2Вручную: положить файлы
.agents/skills/principal-engineering/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill principal-engineering -a cursor2Вручную: положить файлы
.cursor/skills/principal-engineering/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install riekelt/principal-engineer principal-engineering2Вручную: положить файлы
.github/skills/principal-engineering/SKILL.md1Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill principal-engineering -a gemini-cli2Командой платформы
gemini skills install https://github.com/riekelt/principal-engineer --path plugins/principal-engineer/skills/principal-engineeringВручную: положить файлы
.devin/skills/principal-engineering/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill principal-engineering -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о principal-engineering
Как установить principal-engineering в Claude Code?
Выполните команду npx skills add riekelt/principal-engineer --skill principal-engineering -a claude-code.
Что делает скилл principal-engineering?
Он задаёт правила инженерной безопасности для агента: запрещает глушить ошибки, обязывает формулировать чекпоинт до внесения изменений и требует подтверждать результат конкретными тестами.
Что имеет приоритет — правила проекта или этот скилл?
Инструкции проекта в CLAUDE.md и правила репозитория всегда главнее требований скилла. Выбор стиля кода и фреймворков также остаётся за локальными соглашениями проекта.
