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:

yaml

---
name: [короткое имя, до 64 символов]
description: [ЧТО делает + КОГДА активировать, до 1024 символов]
allowed-tools: [список tools, если нужно]
---

Критически важно для description:

•✅ Включи ЧТО делает skill
•✅ Включи КОГДА Claude должен его использовать
•✅ Добавь триггерные фразы ("use when...", "activates when...")
•✅ Упомяни ключевые слова, которые пользователь может сказать

Пример качественного description:

yaml

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:

code

skill-name/
└── SKILL.md

Для среднего skill:

code

skill-name/
├── SKILL.md
└── reference.md

Для сложного skill:

code

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 с ограничениями

Пример:

markdown

## 🛡️ Безопасность

**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

code

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

code

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! 🚀