Как создать свой собственный Claude Code Skill

Как создать свой собственный Claude Code Skill

Skill — это Markdown-файл с frontmatter, который превращается в slash-команду. Создание навыков экономит время на повторяющихся задачах.

Структура Skill-файла

---
name: skill-name
description: Что делает этот skill (используется в /help)
---

Инструкции для Claude Code...

Frontmatter обязателен: name и description. Тело файла — это промпт.

Где хранить skills

~/.claude/skills/          # Глобальные (все проекты)
.claude/skills/            # Только текущий проект

Пример: skill для создания компонента

---
name: component
description: Создать React компонент с TypeScript и Tailwind
---

Создай React компонент по следующим требованиям:
- TypeScript с явными типами для props
- Tailwind CSS для стилей (без inline styles)
- 'use client' только если нужен state или эффекты
- Экспортировать как default export
- Файл: components/{{name}}.tsx

Имя компонента: {{args}}

Если имя не указано, спроси перед созданием.

Вызов: /component UserCard

Пример: skill для git commit

---
name: commit
description: Создать git commit с хорошим сообщением
---

Посмотри git diff --staged и создай коммит:
1. Если ничего не staged — запусти git add -p и предложи мне выбрать
2. Составь сообщение: тип(scope): описание на русском
   - Типы: feat, fix, refactor, docs, test, chore
3. Не включай технические детали реализации в сообщение
4. Запусти git commit с этим сообщением

Вызов: /commit

Аргументы в skills

Аргументы доступны через {{args}} в теле skill:

---
name: explain
description: Объяснить функцию или файл
---

Найди и объясни: {{args}}

Формат объяснения:
1. Что делает (одна строка)
2. Входные данные и их типы
3. Что возвращает
4. Возможные ошибки
5. Где используется в проекте

Вызов: /explain processPayment

Список доступных skills

/help  — показывает все доступные skills с описаниями

Итог

• Skill = Markdown-файл с frontmatter в .claude/skills/ или ~/.claude/skills/
• Обязательные поля: name, description
• Аргументы доступны через {{args}}
• Вызов: /имя-навыка [аргументы]
• /help показывает все доступные skills