раздел 01

Skills в Claude

В Claude навыки называются Agent Skills. Каждый skill - это папка с файлом SKILL.md внутри. В начале файла идёт YAML-frontmatter (блок между двумя строками ---) с метаданными, а ниже - обычный Markdown с инструкциями.

Из чего состоит skill

Папка навыка

Имя папки = имя навыка. Внутри лежит SKILL.md и, по желанию, дополнительные файлы.

SKILL.md

Обязательный файл. Frontmatter с name и description, дальше инструкции в Markdown.

Ресурсы

Опционально: папки scripts, references, assets со скриптами, справочниками и шаблонами.

Frontmatter: name и description

В шапке файла два главных поля. name - короткое имя навыка для списка. description - краткое описание того, что навык делает и когда его применять. Именно по description Claude решает, подключать навык к задаче или нет.

---
name: commit-style
description: Оформляет git-коммиты по стандарту проекта. Применять, когда нужно сделать коммит или сформулировать сообщение коммита.
---

# Стиль коммитов

- Заголовок до 50 символов, в повелительном наклонении.
- Тело: что и зачем, без "как".
- В конце - строка Co-Authored-By.

Оба поля по сути опциональны, но description рекомендуется всегда: без него Claude не понимает, когда навык уместен.

Где лежат навыки

Есть два места. Навыки проекта - в папке .claude/skills внутри репозитория, их видит вся команда и они едут вместе с кодом. Личные навыки - в ~/.claude/skills в домашней директории, они доступны во всех ваших проектах.

проект/
  .claude/
    skills/
      commit-style/
        SKILL.md
      pdf-report/
        SKILL.md
        scripts/
          build.py

Claude находит навыки автоматически при старте - и проектные, и личные.

Как навык подключается

Подключение происходит по описанию: это model-invoked. Claude читает description всех доступных навыков и сам решает, какой релевантен текущей задаче. Когда навык подходит, его тело подгружается и применяется. Можно вызвать навык и вручную - командой /имя-навыка.

Важная деталь: тело навыка не висит в контексте постоянно. Оно подгружается только в момент использования, поэтому длинные справочники в навыке почти ничего не стоят, пока не понадобятся.

Где это работает

Agent Skills работают в Claude Code (терминал и IDE), в Claude.ai и десктоп-приложении, а также через API. Есть встроенные навыки от Anthropic, есть открытый стандарт Agent Skills, по которому навыки совместимы между разными инструментами.