[[Claude Skills — Гайд|← К оглавлению]] · [[Claude Skills - 07. Чеклист|← Чеклист]] --- # YAML frontmatter — справочник Именно по YAML-шапке Claude решает, подключать твой skill или нет. Здесь нельзя ошибиться. ## Минимальный рабочий вариант ```yaml --- name: your-skill-name description: Что делает. Подключать, когда пользователь просит [конкретные фразы]. --- ``` Этого достаточно для старта. ## Полный набор полей ```yaml --- name: skill-name description: Что делает и когда подключать. Перечисли фразы-триггеры. license: MIT allowed-tools: "Bash(python:*) Bash(npm:*) WebFetch" metadata: author: Company Name version: 1.0.0 mcp-server: server-name category: productivity tags: [project-management, automation] documentation: https://example.com/docs support: [email protected] --- ``` ## Обязательные поля **name:** - Только kebab-case — строчные через дефис - Без пробелов и заглавных - Должно совпадать с именем папки **description:** - Обязательно содержит: **что skill делает** и **когда подключать** - Не больше 1024 символов - Никаких XML-тегов (`<` или `>`) - Перечисли конкретные фразы, которые может сказать пользователь ## Правила безопасности | Можно | Нельзя | |---|---| | Любые стандартные YAML-типы | XML-скобки (`< >`) | | Произвольные поля в metadata | Исполняемый код в YAML | | Описания до 1024 символов | Слова «claude» или «anthropic» в имени | Шапка попадает прямо в системный промпт Claude, поэтому ограничения не случайные. ## Частые ошибки ```yaml # Нет разделителей — не сработает name: my-skill description: Does things # Незакрытые кавычки — не сработает description: "Does things # Вот так правильно --- name: my-skill description: Does things --- ``` ```yaml # Неправильно name: My Cool Skill # Правильно name: my-cool-skill ``` --- [[Claude Skills — Гайд|← Вернуться к оглавлению]]