Смотреть урок

Разобрали, как писать SKILL.md так, чтобы агент реально его подхватывал в нужный момент, а не игнорировал или путал с соседними скиллами.

Что внутри:
🔹 Четыре обязательных раздела SKILL.md — как писать триггер, который агент не спутает с похожим запросом
🔹 Три паттерна компоновки скиллов — entry-router, reference-файлы, skill-chain, и когда скилл стоит разделить на два
🔹 Пять тестов перед тем, как использовать скилл — от проверки триггера до аудита pitfalls
🔹 Чеклист «готов к использованию» и признаки того, что скилл всё ещё черновик

💡 Правильно написанный SKILL.md экономит контекст агента и не даёт ему уверенно делать не то

Паттерн 3: Skill chain (цепочка скиллов)

Скиллы ссылаются друг на друга через поле relatedPaths и встроенные пометки «после этого смотри...». Каждый скилл при этом самодостаточен — цепочка нужна только для навигации, чтобы агент понимал следующий шаг.

• Пример из практики: скилл миграций Neon/Drizzle ссылается на скилл паттернов Neon serverless через relatedPaths. Скилл написания скиллов ссылается на чеклист тестирования скиллов и на этот раздел про паттерны компоновки.

Использовать этот паттерн стоит, когда: два скилла естественно идут друг за другом (написать скилл -> протестировать его) или когда у скилла есть известное продолжение за пределами его области. Цепочка носит навигационный, а не процедурный характер.

Делить или объединять

Делить, если:

• у скилла два разных условия срабатывания, которые не должны срабатывать одновременно для одной задачи;
• скилл покрывает одновременно публичную/маркетинговую поверхность И дашборд/личный кабинет пользователя — это разные дизайн-контракты;
• в скилле накапливаются правила, которые уже есть в AGENTS.md (им место там, а не в скилле);
• скилл длиннее одного экрана, и невозможно назвать одну задачу, для которой он существует.

Объединять, если:

• два крошечных скилла всегда срабатывают вместе, и один бессмыслен без другого;
• разделение создаёт дублирование — одна и та же команда оказывается в двух файлах.

Правильный ответ почти всегда — разделить. Объединение чаще всего оказывается просто ленью.

Безопасная перекрёстная ссылка

На другой скилл нужно ссылаться по слагу или пути. Никогда не воспроизводить его содержимое инлайн.

• Нормально: «Перед выполнением этих шагов загрузи скилл ship-pipeline».

• Нормально: «По биллингу смотри credit-metered-ai-endpoints в библиотеке».

• Ненормально: вставлять процедуру другого…