Конфигурация и навыки из нескольких файлов

⏱️ Примерное время: ~12 минут · 🎯 Урок 3 курса «Введение в Agent Skills» · 🎬 видео

Поля метаданных во frontmatter файла SKILL.md

Frontmatter файла SKILL.md описывает навык с помощью набора полей метаданных:

name (обязательное) — название навыка. Только строчные буквы, цифры и дефисы, максимум 64 символа.
description (обязательное) — описание навыка, максимум 1024 символа. Это самое важное поле для сопоставления: именно по нему Claude решает, подходит ли навык к запросу.
allowed-tools (необязательное) — ограничивает набор инструментов, которые может использовать Claude.
model (необязательное) — указывает, какую модель Claude использовать.

Каким должно быть хорошее описание

Хорошее описание (description) отвечает на вопросы:

Что делает этот навык?
Когда Claude следует его применять?

Добавляйте ключевые слова, совпадающие с тем, как вы сами формулируете запросы.

Ограничение инструментов через allowed-tools

Поле allowed-tools позволяет ограничить набор доступных инструментов. Например:

Read, Grep, Glob, Bash

Такой набор ограничивает навык операциями только для чтения. Это полезно для рабочих процессов, чувствительных к безопасности.

Прогрессивное раскрытие (progressive disclosure)

Принцип прогрессивного раскрытия помогает не перегружать контекст:

Держите файл SKILL.md в пределах 500 строк.
Ссылайтесь на вспомогательные файлы (scripts/, references/, assets/), которые Claude читает только при необходимости.

Скрипты

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

Скрипты полезны для:

проверки окружения (валидации);
преобразования данных;
надёжных, проверенных операций.