АссистентНовый вопросИсторияОбласти знаний
Партнёрские проектыСпецпроектыСтать автором
Сменить язык
О РУВИКИ

SKILL.md

SKILL.md ( от англ. skill [skɪl] навык) — основной файл формата гибридного YAML и Markdown, который является ядром Skills[1][2]— папки, в которой собраны инструкции[3], скрипты и ресурсы используемые в системе навыков (Agent Skills или Claude Skills) для ИИ-агентов, таких как Claude от Anthropic под конкретный кейс [4][5].

Общие сведения
SKILL.md
Расширение .md
MIME-тип text/markdown или text/plain (как обычный Markdown)
Сигнатура стандартный YAML-frontmatter в формате Markdown
Разработчик Anthropic
Опубликован 2025
Тип формата Markdown с YAML frontmatter
Содержит YAML и Markdown
Открытый формат? открытый
Сайт github.com/anthropics/sk…

История

Anthropic создала SKILL.md в рамках анонса Agent Skills 16 октября 2025 года[6][7][8]. Репозиторий github.com/anthropics/skills с примерами (включая skill-creator/SKILL.md) опубликован на сайте GitHub[7]. 9 декабря 2025 года формат эволюционировал из команд Claude Code, став открытым стандартом под Agentic AI Foundation (9 декабря 2025)[9].

Структура

SKILL.md представляет собой основной файл в директории навыка (skill), определяющий его метаданные (name, description, version и другие поля) и инструкции для ИИ. Структура[10][11][12][13]: YAML в начале, за которым следуют Markdown с примерами, шагами и ссылками на ресурсы (scripts/, references/, assets/)[14][15].

YAML - фронтматтер (заголовок) (YAML Frontmatter) в начале[16].

  • Обязательные поля:

name: идентификатор навыка (максимум 64 символа. Только строчные буквы, цифры и дефисы. Нельзя начинаться и заканчиваться дефисом.) Должно совпадать с именем родительского каталога[17].

description: максимум 1024 символа. Не пустые. Описывает, что делает навык и когда его использовать. Следует включать конкретные ключевые слова, которые помогают агентам выявлять релевантные задачи.

  • Необязательные поля:

license: название лицензии или ссылка на комплектный файл лицензии.

compatibility: максимум 500 символов. Указывает требования к окружающей среде (предполагаемый продукт, системные пакеты, доступ к сети и т.д.).

metadata: произвольное сопоставление ключ-значений для дополнительных метаданных.

allowed-tools: ограниченный по пространству список предварительно одобренных инструментов, которые может использовать навык. (Экспериментальный)

Тело Markdown (Markdown Body) с инструкциями, примерами и рекомендациями. В инструкциях можно указывать: чего помогает достичь навык, когда использовать навык, пошаговые процедуры, которым необходимо следовать, примеры ожидаемых входных данных и результатов[16].

skill-name/

├── SKILL.md (обязательно: YAML + Markdown)

├── scripts/ (скрипты)

├── references/ (документы)

└── assets/ (шаблоны, файлы)

Примеры

Простой пример файла SKILL.md для Agent Skills в Claude — YAML-фронтматтер с описанием навыка и базовыми инструкциями в Markdown. Этот файл определяет навык для быстрого вызова через slash-команду или автозагрузку в Claude[11][2].

- - -

Фронтматтер (обязательно)

name: weather-checker

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

Необязательные поля:

license: license 1.0

compatibility: Claude 3.5+, MCP weather-серверы (OpenWeatherMap, AccuWeather), интернет-соединение

metadata:

version: "1.0"

languages: "ru,en"

allowed-tools: ["mcp__weather__current", "mcp__weather__forecast"]

- - -

Markdown

# Проверка погоды

## Когда использовать

- Планирование поездок и прогулок

- Работа на улице (строительство, курьерская доставка)

- Выбор одежды по погоде

- Прогноз на выходные/праздники

## Пошаговая процедура

1. **Спросите город** (страна опционально)

2. **Текущая погода**: температура, "ощущается как", осадки, ветер

3. **Прогноз**: 3 дня вперед (макс/мин температура, осадки)

4. **Рекомендации**: зонт, теплая одежда и т.д.

## Формат ответа

## Москва, Россия **Сейчас**: -5°C (ощущается -8°C), снег, ветер 4м/с **Влажность**: 82%

### Прогноз

Завтра -3°C - -9°C , снег , послезавтра -1°C - -7°C , облачно. Рекомендация: Возьмите зонт и теплую куртку.

**Сохраните как**: skills/weather-checker/SKILL.md

**Вызов**: /weather-checker Москва

Назначение

Файл SKILL.md помогает расширять возможности Claude, превращая его в специалиста по конкретным задачам без перегрузки контекста[18][19]:

  • Экономия контекста

Файл SKILL.md в AI-агентах снижает расход токенов за счёт прогрессивной загрузки контекста. Это механизм, который позволяет навыкам (папкам с инструкциями и (опционально) скриптами) подгружаться в контекст агента только когда он определяет их релевантность текущему запросу пользователя[10].

Определяет инструкции, примеры и скрипты для повторяющихся процессов (анализ CSV, перевод, PDF). При вызове (slash-команда или автотриггер) Claude следует шагам точно, как обученный эксперт[3].​

  1. Поддержка тысяч навыков в папках ~/.claude/skills/ или .claude/skills/.
  2. Прогрессивная загрузка: метаданные → инструкции → скрипты/REFERENCE.md.
  3. Интеграция с MCP (Model Context Protocol) для внешних API.

Инструменты

Файлы SKILL.md поддерживаются разными ИИ-инструментами, например:

  • Claude — система Claude Skills, где каждый навык состоит из SKILL.md с инструкциями[3].
  • OpenAI Codex — в системе skills для каждого навыка создаётся директория с SKILL.md, а на основе метаданных навыка генерируется компактный фрагмент Markdown, который вставляется в контекст в начале диалога.
  • Copilot — навыки с файлами SKILL.md работают с агентом кодирования Copilot, GitHub Copilot CLI и режимом агента в Visual Studio Code Insiders[11].

Примечания

  1. ↑ What are skills? - Agent Skills (англ.). agentskills.io. Дата обращения: 12 февраля 2026.
  2. ↑ 1 2 Jason Hsiu. The SKILL.md Format: Complete Specification and Examples, aiskill.market (13 января 2026). Дата обращения: 20 февраля 2026.
  3. ↑ 1 2 3 Расширение Claude с помощью навыков. code.claude.com.
  4. ↑ Создание файла Skill.md. support.claude.com/ru/. Anthropic.
  5. ↑ What Is SKILL.md in Claude Skills? Structure, Resources & Loading, Skywork ai (17 октября 2025). Дата обращения: 20 февраля 2026.
  6. ↑ Third-Party Notices (англ.). GitHub. Дата обращения: 12 февраля 2026.
  7. ↑ 1 2 anthropics/skills: Public repository for Agent Skills (англ.). GitHub. Дата обращения: 12 февраля 2026.
  8. ↑ Alex Tanaka. Anthropic's Claude Skills: What SMB Sales Teams Need to Know (2025), optif.ai (21 октября 2025). Дата обращения: 12 февраля 2026.
  9. ↑ Linux Foundation Announces the Formation of the Agentic AI Foundation (AAIF), Anchored by New Project Contributions Including Model Context Protocol (MCP), goose and AGENTS.md, linuxfoundation.org. Дата обращения: 13 февраля 2026.
  10. ↑ 1 2 Specification - Agent Skills (англ.). agentskills.io. Дата обращения: 20 февраля 2026.
  11. ↑ 1 2 3 Создание и добавление навыков. GitHub.
  12. ↑ Навыки агента (Skills) в Cursor: как расширить ИИ-агента и создавать свои. kv-ai.ru. Дата обращения: 20 февраля 2026.
  13. ↑ Update skill-creator and make scripts executable (англ.). GitHub. Дата обращения: 12 февраля 2026.
  14. ↑ Anatomy of a Skill (англ.). GitHub. Дата обращения: 20 февраля 2026.
  15. ↑ UNPKG (англ.). app.unpkg.com. Дата обращения: 16 февраля 2026.
  16. ↑ 1 2 Specification - Agent Skills (англ.). agentskills.io. Дата обращения: 20 февраля 2026.
  17. ↑ Specification - Agent Skills (англ.). agentskills.io. Дата обращения: 20 февраля 2026.
  18. ↑ Как создать пользовательские Skills | Anthropic Help Center, claude.com. Дата обращения: 13 февраля 2026.
  19. ↑ Расширение Claude с помощью навыков. ClaudeCodeDocs.

Литература

Категории

© Правообладателем данного материала является АНО «Интернет-энциклопедия «РУВИКИ».
Использование данного материала на других сайтах возможно только с согласия АНО «Интернет-энциклопедия «РУВИКИ».