Файл SKILL.md - основа каждого Claude Skill: это файл Markdown, который начинается с короткого заголовка YAML (с name и description), а затем содержит инструкции, которым должен следовать Claude. Описание сообщает Claude, когда использовать Skill, а основная часть - как.
На этой странице
Если вы встречали этот term и задавались вопросом, что именно находится внутри, перед вами описание устройства SKILL.md, почему важна каждая часть и как написать рабочий файл.
Что такое SKILL.md
Claude Skill - это папка, а SKILL.md - обязательный файл в её корне. Это обычный Markdown, поэтому его можно открыть в любом текстовом редакторе. Claude читает его, чтобы освоить определённую способность - шаги, правила и лучшие практики для выполнения конкретного типа задач. Дополнительные материалы (шаблоны, скрипты, справочные файлы) могут находиться в той же папке, но SKILL.md - единственный файл, который должен быть в каждом Skill.
Хотите увидеть хорошо структурированный SKILL.md вместо того, чтобы создавать его с нуля? Блок метаданных и инструкции Yuri уже написаны и протестированы для выявления ошибок, уязвимостей безопасности и проблем с производительностью при проверке кода.
Посмотреть Skill Yuri - Code Reviewer AI →Две части SKILL.md
1. Блок метаданных (frontmatter)
В самом верху находится небольшой блок YAML между маркерами ---. В нём содержатся основные метаданные - как минимум name и description:
---
name: weekly-report
description: Форматирует необработанные заметки в наш стандартный еженедельный отчёт. Используйте, когда пользователь просит подготовить еженедельное обновление, отчёт о состоянии или «подвести итоги недели».
---Этот блок особенный: когда начинается сеанс, Claude предварительно загружает только название и описание каждого установленного Skill, а не весь файл. Это помогает экономить место в контекстном окне и объясняет, почему описание выполняет такую важную работу.
2. Основная часть (инструкции)
Ниже блока метаданных в обычном Markdown укажите, что именно должен делать Claude, - в идеале в виде понятных пронумерованных шагов с правилами или примерами:
## Шаги
1. Сгруппируйте заметки по разделам «Успехи», «В процессе» и «Блокеры».
2. Каждый пункт должен состоять из одного предложения в прошедшем времени.
3. Завершайте однострочным итогом «На следующей неделе».
4. Никогда не придумывайте метрики, которых нет в заметках.Почему описание - самая важная строка
Запуск полностью зависит от описания. Во время работы Claude сравнивает ваш запрос с описанием каждого навыка и загружает полный файл только при совпадении. Расплывчатое описание («помогает составлять отчёты») редко срабатывает. Конкретное описание («используйте, когда пользователь просит подготовить еженедельное обновление или отчёт о состоянии») срабатывает надёжно. Если запомнить только одно правило, пусть это будет следующее: описывайте, когда использовать навык, а не только то, что он собой представляет.
Как Claude использует файл
- При запуске: Claude читает название и описание каждого навыка.
-
Во время выполнения задачи: если ваш запрос соответствует описанию, Claude загружает полный файл
SKILL.md(и все прикреплённые ресурсы) этого навыка. - Затем: Claude выполняет работу, следуя инструкциям в основной части файла.
Этот подход «загружать только при необходимости» называется прогрессивным раскрытием и позволяет устанавливать множество навыков, не перегружая контекст модели.
Как написать хороший SKILL.md
- Точно сформулируйте описание. Чётко укажите, когда должен запускаться навык.
- Начните с небольшой первой версии. Пять-десять строк с понятными шагами лучше, чем длинный и громоздкий документ.
- Будьте конкретны. Используйте нумерованные шаги, чёткие правила и короткий пример.
- Тестируйте на реальных задачах. Расширяйте навык только там, где Claude допускает ошибки.
Нужно ли создавать его самостоятельно?
Нет. Создавать собственные навыки отлично подходит для уникальных рабочих процессов, но если вам просто нужен результат, готовые навыки уже содержат тщательно подготовленный и протестированный файл SKILL.md. Просмотрите библиотеку KissMySkills с более чем 1 000 навыков, наборов prompt и агентов или коллекцию навыков Claude Code. Хотите сначала увидеть один из них в работе? Попробуйте бесплатный генератор или скачайте бесплатный навык.
Не каждый SKILL.md предназначен для программистов - frontmatter и инструкции Ryan написаны для подготовки материалов к заседаниям совета директоров, меморандумов для общих собраний и брифингов для руководителей, редактирование не требуется.
Посмотреть AI Skill Ryan - Chief of Staff →Часто задаваемые вопросы
SKILL.md - это просто Markdown?
Да - это стандартный файл Markdown с блоком YAML frontmatter в начале. Он открывается в любом текстовом редакторе, специальное ПО не требуется.
Что должно быть в SKILL.md?
Как минимум, блок frontmatter с именем и описанием. Текст с инструкциями делает Skill полезным, а метаданные позволяют обнаруживать его и запускать.
Где должен находиться файл SKILL.md?
В корне папки Skill. В Claude Code Skills хранятся в ~/.claude/skills/<name>/ для личного использования или .claude/skills/<name>/ внутри проекта, в папке SKILL.md в корне папки.
Можно ли использовать содержимое SKILL.md в ChatGPT или Gemini?
Да. Инструкции можно использовать в разных системах - вставьте текст в пользовательские инструкции ChatGPT или Gemini и получите то же поведение. Автоматический запуск через frontmatter - это функция Claude.
Кратко:
Если вы предпочитаете не писать YAML frontmatter самостоятельно, Yuri - Code Reviewer станет отличным выбором для разработчиков, а Ryan - Chief of Staff поможет с текстами для руководителей и бизнеса. Все они работают в Claude, ChatGPT и любых AI-чатах, не требуя навыков программирования, и предоставляются с 30-дневной гарантией возврата денег.
Начните с рабочего примера
Самый быстрый способ понять, что такое SKILL.md, - прочитать хороший пример. Возьмите бесплатный Skill, откройте файл и посмотрите, как на практике устроена структура из frontmatter и шагов - затем за три минуты прочитайте инструкцию по установке.