Один SKILL.md на всех агентов: manifest, Data Forge и упаковка под Cursor

GitHub разобрал agent skills как версионную папку вокруг SKILL.md: в файле — когда звать задачу, что на входе и что агент должен вернуть. Скилл можно переносить между клиентами, но доступ к базе, CLI и секретам по-прежнему даёт среда, а не markdown с инструкциями.

На GitHub Universe 2026 с Procore авторы прошли от одиночного навыка до цепочки с проверками. Если в одном репозитории крутятся и Cursor, и Copilot, выгоднее держать один источник в skills/*/SKILL.md и собирать клиентские манифесты скриптом, а не копировать тексты вручную.

Один навык — одна работа

Skill срабатывает лучше, когда у него узкая работа, явный вход и выход. В Proof Agent отдельный верификатор проверяет AI-сгенерированные изменения и не опирается на самооценку кодирующего агента — в frontmatter прямо записано: самопроверка не считается проверкой.

В workflow через GitHub Actions верификатор получает исходный запрос и дифф, возвращает PASS, FAIL или PARTIAL и обязан сослаться на строки в изменённых файлах. Параметр block-on-fail по умолчанию роняет проверку при FAIL; в демо его отключали, чтобы замечания шли как рекомендации.

Несколько skills и manifest

Data Forge разносит суждение по ролям: forge-init исследует таблицы и конвенции и пишет resolved manifest, forge-builder ведёт задачу до pull request, forge-dbx и forge-lint — запросы к платформе и стандарты команды. В примере support-desk manifest задаёт DuckDB и spark_python, чтобы skills не хардкодили имена проекта.

В пайплайне семь фаз, на каждой — человеческий чекпоинт перед следующим шагом. Шаг поменялся — правят один skill, остальные не трогают.

Упаковка под Cursor и CI

Скрипт генерирует .cursor-plugin/plugin.json для Cursor, .claude-plugin/plugin.json для Claude Code и .github/agents/*.agent.md для GitHub Copilot. В CI можно запускать node scripts/package.mjs --check, чтобы убедиться, что копии инструкций не разъехались.

Три практики из гайда

• Контекст проекта — в manifest, skills только читают его, а не дублируют схемы и имена.
• Связанные skills делят один путь к платформе: forge-dbx выбирает адаптер Databricks или DuckDB по manifest.
• Инструкции ведут работу, тесты и проверки в репозитории ловят ошибки; блокировку merge настраивают в правилах CI, не в тексте skill.

Авторы советуют стартовать с задачи, которую вы уже устали объяснять в чате: записать вход, границу и что видит ревьюер, прогнать на другом агенте и допилить. Skills удобны для чеклистов, релизов и метрик-пайплайнов; если нужен жёсткий аудит, долгий контроль или права вне модели — лучше обычное приложение.

Источник: Build once, run on any agent: A practical guide to agent skills.