Практическое руководство по созданию навыков Claude: структура, триггеры и скрипты

Что такое Claude Skills и как они работают

Claude Skills — это инструкции, которые автоматизируют конкретные задачи, в отличие от Проектов (баз знаний) и Model Context Protocol (слой подключения для живых данных). Если вы набирали одни и те же инструкции в начале более трёх разговоров — это навык, который просится быть созданным.

Структура и настройка навыка

Навык — это папка, содержащая один файл под названием SKILL.md. Базовая структура:

your-skill-name/
├── SKILL.md
└── references/
    └── your-ref.md

Поместите папку в ~/.claude/skills/ на вашем компьютере. Claude найдёт её автоматически.

Триггеры YAML: механизм активации

Вверху SKILL.md напишите метаданные между строками ---, чтобы сообщить Claude, когда активироваться. Пример:

---
name: csv-cleaner
description: Преобразует неаккуратные CSV-файлы в чистые таблицы. Используйте этот навык всякий раз, когда пользователь говорит 'очисти этот CSV', 'исправь заголовки', 'отформатируй эти данные' или 'организуй эту таблицу'. НЕ используйте для PDF, документов Word или файлов изображений.
---

Следуйте трём правилам: пишите от третьего лица, перечисляйте точные фразы-триггеры и устанавливайте отрицательные границы. Поле описания — самая важная строка во всём навыке — слабое описание означает, что навык никогда не сработает.

Когда инструкций недостаточно: директория скриптов

Простые инструкции на английском языке обрабатывают суждения, язык, форматирование и решения. Для задач, требующих фактических вычислений, добавьте папку scripts/.

Используйте инструкции для: "перепиши это в нашем фирменном стиле" или "категоризируй эти заметки с собрания".

Используйте скрипты для: "рассчитай скользящее среднее этих чисел", "распарсь этот XML и извлеки определённые поля" или "измени размер всех изображений в этой папке до 800x600".

Структура папки для навыка, использующего и то, и другое:

data-analyser/
├── SKILL.md
├── references/
│   └── analysis-template.md
└── scripts/
    ├── parse-csv.py
    └── calculate-stats.py

Внутри SKILL.md ссылайтесь на скрипты так:

## Рабочий процесс
1. Прочитайте загруженный CSV-файл, чтобы понять его структуру.
2. Запустите scripts/parse-csv.py для очистки данных:
   - Команда: `python scripts/parse-csv.py [input_file] [output_file]`
   - Это удаляет пустые строки, нормализует заголовки и обеспечивает типы данных.
3. Запустите scripts/calculate-stats.py на очищенных данных:
   - Команда: `python scripts/calculate-stats.py [cleaned_file]`
   - Это выводит: среднее, медиану, стандартное отклонение и выбросы для каждого числового столбца.
4. Прочитайте статистический вывод и напишите понятное человеку резюме, следуя шаблону в references/analysis-template.md. Выделите любые аномалии или выбросы, которые могут беспокоить нетехнического читателя.

Скрипты обрабатывают вычисления; инструкции обрабатывают суждения. Одно правило для скриптов: один скрипт — одна задача. parse-csv.py не должен также рассчитывать статистику. Держите их сфокусированными, принимайте пути к файлам как аргументы, никогда не жёстко кодируйте пути и всегда включайте обработку ошибок, чтобы Claude мог читать сбои и сообщать о них чисто.

Ссылки: правило одного уровня вложенности

Если навыку нужен бренд-гайд или шаблон, поместите его в references/ и ссылайтесь на него из SKILL.md. Никогда не допускайте, чтобы файлы ссылок ссылались на другие файлы ссылок — Claude обрежет своё чтение и пропустит вещи. Только один уровень вложенности.

your-skill-name/
├── SKILL.md
└── references/
    └── brand-voice-guide.md ← ссылайтесь на это из SKILL.md ← никогда не ссылайтесь отсюда на другой файл

В SKILL.md: Прежде чем начать задачу, прочитайте руководство по фирменному стилю по ссылке references/brand-voice-guide.md

Оркестрация нескольких навыков: предотвращение конфликтов

Как только у вас развёрнуто пять или более навыков, начинаются конфликты — например, активация регулятора фирменного стиля, когда вы хотели составителя электронных писем. Три правила останавливают это:

• Правило 1: Непересекающиеся территории. Каждый навык владеет чётко определённой областью (например, регулятор фирменного стиля обрабатывает соответствие стилю, составитель писем обрабатывает составление, преобразователь контента обрабатывает преобразование формата). Никакого смешения.
• Правило 2: Агрессивные отрицательные границы.