Agent Skills стали открытым стандартом: как написать свой первый SKILL.md

Когда технология передаётся независимому фонду, это обычно означает, что она перестала быть экспериментом одной компании. Именно это только что произошло с Agent Skills — форматом, в котором AI-агентам описывают рабочие процедуры. И если вы работаете с Claude Code, Cursor или Copilot, это напрямую влияет на то, как вы будете ими пользоваться в следующем году.

Что произошло 22 октября

Anthropic передала Agent Skills в Agentic AI Foundation (AAIF) — проект Linux Foundation, который Anthropic соосновала вместе с Block и OpenAI. Раньше туда же передали MCP (Model Context Protocol), так что теперь два базовых формата агентной экосистемы живут в одном нейтральном месте.

Передали не только код, но и всё, что делает проект проектом: название и логотип, организацию на GitHub и домен agentskills.io, где опубликована спецификация. Поддерживают стандарт инженеры из Anthropic, Google, OpenAI и других компаний — причём как отдельные люди, а не представители работодателей. Lead Maintainers — David Soria Parra и Mahesh Murag.

Несколько цифр для масштаба. Стандарт опубликовали в декабре 2025 года, и за это время его интегрировали более 70 агентных платформ, среди них ChatGPT, Cursor, GitHub Copilot и VS Code. Опубликовано около миллиона скилов, а количество установок — около 280 миллионов.

Важная деталь для тех, кто настороженно относится к «открытым» стандартам крупных компаний: пользоваться Agent Skills и делать вклад можно без вступления в фонд. В заявленной дорожной карте — версионирование релизов, формальный процесс предложений и отдельные рекомендации по безопасности.

Что такое скил на самом деле

Определение простое до разочарования: скил — это папка с файлом SKILL.md, который обучает агента конкретной задаче или предметной области, плюс любые скрипты и справочные материалы, нужные для этой работы.

Никакого нового формата данных, никакого SDK. Текстовый файл и папка.

Anthropic разработала этот формат, работая над Claude Code, и причина была конкретная: модели хорошо знают языки программирования, но не знают вашего порядка действий. Как именно в вашей команде делают code review. Какие поля обязательны в вашем отчёте. Что означает «готово» для вашей задачи. Это процедурные знания, и раньше их приходилось каждый раз пересказывать в чате.

Скилы против MCP: в чём разница

Это самая частая путаница, и её стоит развести сразу, тем более что оба стандарта теперь в одном фонде.

• MCP отвечает на вопрос «к чему у агента есть доступ». Он подключает инструменты, источники данных и внешние системы: базу, трекер задач, файлы, API.
• Agent Skills отвечают на вопрос «как именно выполнять работу». Это порядок шагов, критерии качества, типичные ошибки, границы задачи.

Короткая аналогия: MCP даёт агенту руки, а скил — инструкцию. Доступ к базе не подсказывает, как делать месячный отчёт; описание процедуры отчёта не поможет, если доступа к базе нет. На практике они работают вместе. Если MCP для вас новая тема, начните со статьи что такое MCP или с короткого определения в глоссарии.

Пишем первый SKILL.md

Лучший способ понять формат — сделать скил для своей рутинной задачи. Возьмём реальную: проверка Python-кода перед открытием pull request.

Структура папки:

code-review-python/
  SKILL.md
  checklist.md

Сам SKILL.md — это текст с коротким заголовком-описанием и телом инструкции:

---
name: code-review-python
description: Проверяет Python-код перед pull request по командному
  чеклисту. Использовать перед созданием PR или когда просят
  "проверь мой код".
---

# Проверка Python-кода перед PR

## Когда применять
Перед открытием pull request или по прямому запросу о проверке кода.

## Порядок действий
1. Прочитай diff полностью, прежде чем комментировать хоть что-то.
2. Пройди `checklist.md` по пунктам и для каждого дай вердикт:
   ок / проблема / не применяется.
3. Для каждой проблемы укажи файл и строку, причину и конкретное
   предложение — не общий совет.
4. Отдельно проверь тесты: есть ли они на новый код и проверяют ли
   поведение, а не реализацию.
5. Подведи итог тремя строками: что блокирует merge, что стоит
   исправить сейчас, что можно оставить на потом.

## Чего не делать
- Не переписывай код без запроса.
- Не комментируй стиль, если его контролирует линтер.
- Не говори "выглядит хорошо", если не прошёл чеклист.

В checklist.md вы складываете собственные пункты: обработка ошибок, валидация входных данных, логирование без персональных данных, миграции БД, обратная совместимость API — то, на чём ваша команда реально спотыкается.

Точные поля спецификации и то, куда именно кладётся папка скила, зависят от инструмента — смотрите документацию своего агента и спецификацию на agentskills.io. Но принцип одинаковый: описание, по которому видно, когда применять, и тело с порядком действий.

Как писать скилы, которые действительно работают

1. Описание важнее тела. Именно по описанию агент решает, брать ли скил вообще. «Проверка кода» — плохое описание. «Проверяет Python-код перед pull request по командному чеклисту» — рабочее.
2. Один скил — одна задача. Скил «всё про наш проект» не применится никогда, потому что непонятно, когда он нужен.
3. Пишите порядок, а не пожелания. «Качественно проверь код» не является инструкцией. «Прочитай diff полностью, затем пройди чеклист по пунктам» — является.
4. Добавьте раздел «чего не делать». Он экономит больше времени, чем любой другой раздел.
5. Выносите детали в отдельные файлы. Длинные чеклисты, примеры и справочники лучше держать рядом и упоминать в SKILL.md, а не вкладывать всё в один файл.
6. Проверьте на реальной задаче. Скил, который ни разу не применялся, почти всегда содержит пропущенный шаг.

Безопасность: чужие скилы — это чужой код

Миллион опубликованных скилов означает, что большинство из них писали незнакомые вам люди. Скил может содержать скрипты, а значит установка чужого скила — это то же самое, что запуск чужого кода: его нужно прочитать перед применением.

То, что в дорожной карте стандарта отдельно заявлены рекомендации по безопасности для авторов и для тех, кто устанавливает скилы, стоит читать как признание: проблема реальна и о ней думают на уровне стандарта. До появления этих рекомендаций правило простое — откройте SKILL.md и посмотрите, что он просит сделать.

Что это значит для разработчика

Передача стандарта в фонд — сигнал, что формат не исчезнет вместе со сменой стратегии одной компании. Для вас это значит, что время, потраченное на понимание формата, не пропадёт.

Но есть более важный вывод. Когда агент умеет выполнить процедуру, ценность смещается к умению эту процедуру сформулировать: разложить работу на шаги, определить критерии готовности, назвать границы и типичные ошибки. Это тот же навык, который нужен для работы в команде с людьми — писать понятные задачи и чёткие определения готовности. Просто теперь у него появилось ещё одно применение и заметный эффект.

Практический шаг на эту неделю: возьмите одну задачу, которую вы делаете каждую неделю руками, и опишите её в SKILL.md. Даже если вы не пользуетесь агентами ежедневно, сама попытка показывает, насколько хорошо вы понимаете собственный процесс.

Где научиться работать с AI-агентами

• Claude Code: практический курс для начинающих — именно тот инструмент, для которого формат скилов и создавался.
• Claude Chat для начинающих — если вы ещё не писали сложных запросов к модели.
• AI Automation — когда интересна автоматизация процессов, а не только код.

Полезные соседние материалы: полное руководство по Claude Code и первый проект в вайб-кодинге.

Частые вопросы

Что такое Agent Skills простыми словами?

Это способ передать AI-агенту рабочую процедуру. Скил — это обычная папка с файлом SKILL.md, в котором описано, как выполнять конкретную задачу, плюс любые скрипты или справочные материалы для неё. Агент читает этот файл и действует по описанному порядку, вместо того чтобы придумывать подход каждый раз заново.

Чем Agent Skills отличаются от MCP?

MCP отвечает на вопрос «к чему у агента есть доступ» — он подключает инструменты, данные и внешние системы. Agent Skills отвечают на вопрос «как именно выполнять работу» — это процедурные знания: порядок шагов, критерии качества, типичные ошибки. MCP даёт агенту руки, скилы дают ему инструкцию.

Где лежит файл SKILL.md и как агент его находит?

Скил — это папка с файлом SKILL.md внутри; расположение папки зависит от конкретного инструмента, поэтому точные пути стоит смотреть в документации своего агента. Спецификация самого формата опубликована на agentskills.io.

Безопасно ли устанавливать чужие скилы?

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

Нужно ли вступать в Agentic AI Foundation, чтобы пользоваться стандартом?

Нет. Стандарт остаётся открытым: пользоваться им и делать вклад можно без участия в фонде. Передача в фонд нужна для того, чтобы направление развития определяло сообщество, а не одна компания.

Зачем это человеку, который только учится программировать?

Потому что это меняет навык, за который платят. Умение описать процесс так, чтобы его выполнил агент — порядок шагов, критерии готовности, границы — это тот же навык, который нужен для работы с людьми в команде. Начать можно с одного скила для своей рутинной задачи.

Источники

• Anthropic — Donating Agent Skills to the Agentic AI Foundation (22 октября 2026)
• agentskills.io — спецификация Agent Skills