AI-агент пишет код быстро. Именно поэтому он так же быстро может повторить старую ошибку: вручную описать типы, обойти принятый API-клиент, забыть обновить документацию или добавить тест, который проверяет не пользовательский сценарий, а удобный кусок кода.

В обычной команде часть этого знания передаётся на ревью. Кто-то помнит, где лежит канон, какой генератор запускать, почему нельзя править generated-файлы руками. Агент этого не помнит между задачами, если не дать ему явные ориентиры.

Скилл хорош не тогда, когда превращается в двадцать страниц запретов. Его задача проще: в нужный момент сказать, какие файлы прочитать, что считать источником правды, куда не лезть и чем проверить результат. Например, перед работой с формой напомнить про generated Zod-схемы, а перед изменением API направить к спецификации и проверкам контракта.

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

Плохой скилл заставляет выполнять ритуал. Хороший убирает ритуал из головы и оставляет внимание на задаче.

А у вас AI получает правила в репозитории или каждый раз работает только по сообщению в чате❓

Что оказалось полезнее: короткие ограничения или подробные плейбуки для повторяющихся задач❓