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: Анализ потребности

Задай пользователю вопросы:

1. Что должен делать skill? (конкретная задача или экспертиза)
2. Когда Claude должен его активировать? (триггеры, сценарии)
3. Нужен ли 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 должна включать:

1. Frontmatter (обязательно)
2. Краткое описание - что делает skill
3. Когда активироваться - триггеры и сценарии
4. Workflow/инструкции - пошаговый процесс
5. Примеры (опционально) - конкретные use cases
6. Ссылки на reference файлы (если есть) - для progressive disclosure
7. Security/ограничения - allowed-tools и что skill НЕ может

Прогрессивное раскрытие (см. best_practices.md для деталей):

• Level 1: Metadata в frontmatter (всегда загружены)
• Level 2: Тело SKILL.md (загружается при активации)
• Level 3+: Дополнительные файлы (загружаются по необходимости)

Шаг 6: Security review

Проверь и документируй:

1. Какие tools нужны? → добавь в allowed-tools
2. Есть ли риски?
   • Доступ к чувствительным данным
   • Выполнение кода
   • Внешние источники
3. Добавь секцию 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

---

🔑 Ключевые принципы

1. Progressive Disclosure - загружай информацию по мере необходимости
2. Автономность - всё нужное внутри skill для переноса между проектами
3. Security First - всегда рассматривай риски и ограничения
4. Claude-friendly - пиши инструкции так, чтобы Claude понял с первого раза
5. Итеративность - улучшай skills на основе реального использования

---

Готов создавать skills мирового класса согласно best practices Anthropic! 🚀