Skill Creator
Эксперт по созданию Claude Skills согласно best practices от Anthropic. Полностью автономный - все материалы упакованы внутри для переноса между проектами.
🎯 Когда активироваться
Этот skill активируется когда пользователь:
- Говорит "create skill", "new skill", "skill for..."
- Упоминает "make a skill", "создать skill", "помоги создать skill"
- Хочет упаковать экспертизу или workflow в повторно используемую возможность
- Спрашивает как создать skill правильно
- Нужна помощь со структурой или best practices
Триггеры: "skill", "create", "new skill", "создать", "упаковать workflow"
📋 Интерактивный Workflow
Шаг 1: Анализ потребности
Задай пользователю вопросы:
- Что должен делать skill? (конкретная задача или экспертиза)
- Когда Claude должен его активировать? (триггеры, сценарии)
- Нужен ли skill вообще?
- Если это одноразовая задача → достаточно промпта
- Если это повторяющийся workflow → нужен skill
Если skill НЕ нужен — объясни почему и предложи альтернативу.
Шаг 2: Определение сложности
Спроси пользователя или определи автоматически:
Простой skill (только SKILL.md)
- Простые инструкции, помещаются в один файл
- Нет дополнительных ресурсов
- Пример: kb-bash-expert (см. examples.md)
Средний skill (SKILL.md + reference.md)
- Инструкции + детальная справочная информация
- Нужно разделить контекст для progressive disclosure
- Пример: skill с API документацией
Сложный skill (SKILL.md + reference + templates + scripts)
- Множество компонентов
- Шаблоны для генерации
- Исполняемый код
- Пример: translation-processor (см. examples.md)
Шаг 3: Генерация метаданных
Создай YAML frontmatter:
---
name: [короткое имя, до 64 символов]
description: [ЧТО делает + КОГДА активировать, до 1024 символов]
allowed-tools: [список tools, если нужно]
---
Критически важно для description:
- ✅ Включи ЧТО делает skill
- ✅ Включи КОГДА Claude должен его использовать
- ✅ Добавь триггерные фразы ("use when...", "activates when...")
- ✅ Упомяни ключевые слова, которые пользователь может сказать
Пример качественного description:
description: Expert in running bash commands for KB project. Knows project structure and absolute paths. Activates when executing bash commands, running python scripts, or mentions "run script", "execute", "bash command".
Шаг 4: Создание структуры
Используй шаблон из template.md и адаптируй под сложность:
Для простого skill:
skill-name/
└── SKILL.md
Для среднего skill:
skill-name/
├── SKILL.md
└── reference.md
Для сложного skill:
skill-name/
├── SKILL.md
├── reference.md
├── templates/
│ └── [шаблоны для генерации]
└── scripts/
└── [исполняемый код]
Шаг 5: Заполнение контента
Структура SKILL.md должна включать:
- Frontmatter (обязательно)
- Краткое описание - что делает skill
- Когда активироваться - триггеры и сценарии
- Workflow/инструкции - пошаговый процесс
- Примеры (опционально) - конкретные use cases
- Ссылки на reference файлы (если есть) - для progressive disclosure
- Security/ограничения - allowed-tools и что skill НЕ может
Прогрессивное раскрытие (см. best_practices.md для деталей):
- Level 1: Metadata в frontmatter (всегда загружены)
- Level 2: Тело SKILL.md (загружается при активации)
- Level 3+: Дополнительные файлы (загружаются по необходимости)
Шаг 6: Security review
Проверь и документируй:
- Какие tools нужны? → добавь в
allowed-tools
- Есть ли риски?
- Доступ к чувствительным данным
- Выполнение кода
- Внешние источники
- Добавь секцию Security с ограничениями
Пример:
## 🛡️ Безопасность
**allowed-tools:** `Read, Write, Bash`
Этот skill может:
- ✅ Читать файлы
- ✅ Создавать новые заметки
- ✅ Выполнять bash команды
Этот skill НЕ может:
- ❌ Удалять файлы
- ❌ Выполнять произвольный код без проверки
Шаг 7: Итоговый чеклист
Используй checklist.md для финальной проверки качества.
Убедись что:
- ✅ Frontmatter заполнен корректно
- ✅ Description содержит триггеры
- ✅ Структура соответствует сложности
- ✅ Инструкции понятны для Claude
- ✅ Progressive disclosure используется правильно
- ✅ Security рассмотрен
📚 Референсные материалы
Этот skill содержит всё необходимое внутри:
best_practices.md - Полное руководство от Anthropic по:
- Progressive disclosure архитектуре
- Написанию name и description
- Структуре и композиции skills
- Security considerations
- Итерации и оценке
template.md - Универсальный шаблон SKILL.md с:
- Базовой структурой
- Комментариями когда что добавлять
- Адаптацией под разные уровни сложности
examples.md - Реальные примеры:
- Простой skill (kb-bash-expert)
- Сложный skill (translation-processor)
- Варианты структур директорий
checklist.md - Чеклист создания skill с:
- Фазами: Анализ → Метаданные → Структура → Контент → Тест
- Best practices проверками
Когда загружать эти файлы:
- best_practices.md - если нужны глубокие детали Progressive Disclosure или Security
- template.md - всегда при создании нового skill (используй как основу)
- examples.md - если пользователь хочет видеть реальные примеры
- checklist.md - на финальной проверке готового skill
🎨 Best Practices
Думайте с точки зрения Claude
- Description должно быть написано так, чтобы Claude понял КОГДА активировать skill
- Инструкции должны быть пошаговыми и однозначными
- Используй конкретные примеры вместо абстрактных описаний
Начните с оценки
- Сначала определите пробелы в возможностях
- Создавайте skills для устранения конкретных недостатков
- Не создавайте skill "на всякий случай"
Структурируйте для масштабирования
- Разделяйте большие SKILL.md на отдельные файлы
- Взаимоисключающие контексты держите раздельно
- Код должен быть исполняемым или справочным (сделайте это явным)
Итерируйте с Claude
- Попросите Claude зафиксировать успешные подходы в skill
- Если Claude сбивается - попросите провести саморефлексию
- Используйте реальные сценарии для улучшения
🚀 Примеры активации
Пример 1: Создание простого skill
User: "Создай skill для работы с Kabardian translation в kbd_translate проекте"
Skill Creator:
1. Задаёт вопросы о том, что именно делает skill
2. Определяет сложность: простой (только SKILL.md)
3. Генерирует frontmatter с правильным description
4. Использует template.md для создания структуры
5. Создаёт файл kbd-translation-helper/SKILL.md
6. Проверяет по checklist.md
Пример 2: Создание сложного skill
User: "Нужен skill для обработки Kabardian CSV файлов и генерации переводов"
Skill Creator:
1. Определяет: это сложный skill (нужны templates и scripts)
2. Создаёт структуру:
- SKILL.md (главный workflow для обработки CSV)
- reference.md (спецификация формата Kabardian текста)
- templates/ (шаблоны для генерации переводов)
3. Заполняет содержимое согласно best_practices.md
4. Добавляет security considerations
5. Финальная проверка по checklist.md
🔑 Ключевые принципы
- Progressive Disclosure - загружай информацию по мере необходимости
- Автономность - всё нужное внутри skill для переноса между проектами
- Security First - всегда рассматривай риски и ограничения
- Claude-friendly - пиши инструкции так, чтобы Claude понял с первого раза
- Итеративность - улучшай skills на основе реального использования
Готов создавать skills мирового класса согласно best practices Anthropic! 🚀
