Необязательное продолжение про скиллы.

Как подойти к сборке своего скилла, чтобы не закопаться?

Всегда начинайте с того, что диктуете модели свой реальный процесс. Например: "беру черновик, анализирую связи тут и тут, формулирую критерии приемки, описываю в таком вот формате результат. Нет черновика - спроси, нет ссылки на док - спроси". Мой собственный фейл - прийти к агенту с просьбой «сделай мне скилл для требований» и уйти пить кофе. Модель сгенерирует красивый файл из стерильных общих слов вроде «handle errors appropriately». Это будет идеальный документ из методички, который на практике окажется абсолютно бесполезным.

И скормите агенту проверенные источники (или попросите нагуглить свежие):

- материал про то, как правильно очерчивать скоуп скилла и почему бесполезно высасывать правила из головы модели.

- статья от Anthropic о том, как они пишут скиллы для Claude Code. Оттуда как раз ключевой тезис: «The highest-signal content in any skill is the Gotchas section».

- официальный подробный гайд «The Complete Guide to Building Skills for Claude» на 33 страницы, можно скормить агенту.

Затем поставьте агенту условия:

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

⸻

Побочный эффект всей этой автоматизации.

На сегодня у меня в строю трое собственных скиллов и больше десятка заметок о том, как со мной вообще надо разговаривать агентам (+ 10 скиллов в личном клоде). И это уже после генеральной чистки на прошлой неделе.

Где-то здесь проходит очень тонкая граница между «я зафиксировал и оптимизировал процесс» и «я развел махровую бюрократию на одного человека». И я эту границу регулярно замечаю и иду вычищать лишнее.

Но пока эта система избавляет меня от необходимости в десятый раз объяснять новой нейросети формат Jira-тикета - для меня она себя полностью окупает. Не так давно наличие папки скиллов сделало переезд из Codex в Cursor почти безболезненным - я просто перенес скиллы и попросил их чуть причесать под новый харнесс.

Кстати, в AI BA/PO Playbook под это дело выделена целая глава: с пошаговым разбором, промтом для правильной сборки и четырьмя готовыми файлами SKILL.md под типовые задачи аналитика, которые можно просто скачать и забрать себе:
https://sazanavets.cc/toolkit/