# skill-creation-guide

Помогает проектировать скиллы для Claude Code: описывает структуру, выбор уровня подробности и разделение инструкций с дополнительными файлами.

- скилл · `type=skill` · Claude Code · 188 установок
- Автор: davila7
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/development/skill-creation-guide
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/skill-creation-guide

## Что делает

Скилл подсказывает, как создавать новый скилл или дорабатывать существующий. Он разбирает обязательный `SKILL.md` с полями `name` и `description`, а также необязательные каталоги `scripts/`, `references/` и `assets/`. Это пригодится, когда нужно упаковать специальные знания, порядок действий или интеграцию с инструментом.

В руководстве есть принцип постепенной загрузки: краткие метаданные доступны постоянно, тело инструкций подключается при срабатывании, а ресурсы — по необходимости. Для хрупких операций оно предлагает задавать точные шаги, а для задач с несколькими допустимыми решениями оставлять больше свободы. Подробные справочные материалы стоит выносить из `SKILL.md`, иначе растёт объём контекста.

Для работы нужны Claude Code и установленный файл скилла. Руководство не создаёт скилл автоматически: оно помогает спланировать его содержимое. `SKILL.md` обязателен, а дополнительные ресурсы добавляют только при необходимости.

## Установка

### Claude Code (родная платформа)

1. **Через claude-code-templates**
```bash
npx claude-code-templates@latest --skill development/skill-creation-guide
```

2. **Через Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill skill-creation-guide -a claude-code
```

3. **Вручную: положить файлы**
- Файл: `~/.claude/skills/skill-creation-guide/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/skill-creation-guide/

### Codex

**Вручную: положить файлы**
- Файл: `.agents/skills/skill-creation-guide/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/skills/skill-creation-guide/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates skill-creation-guide
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/skill-creation-guide/SKILL.md`

### Gemini CLI

**Командой платформы**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/development/skill-creation-guide
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/skill-creation-guide/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/development/skill-creation-guide

## Когда брать
- спроектировать структуру нового скилла
- добавить метаданные, по которым скилл срабатывает
- разделить инструкции и справочные материалы
- выбрать, когда использовать скрипты или шаблоны
- сократить лишние файлы в составе скилла

## Примеры запросов агенту
- Помоги спроектировать скилл для обработки PDF с понятными метаданными и структурой файлов.
- Проверь мой `SKILL.md` и предложи, что перенести в `references/`.
- Определи, где для моего скилла нужны скрипты, а где достаточно текстовых инструкций.

## Похожие
- [find-skills](https://affpapa.org/nevibecode/skills/find-skills.md) — скилл · 4000000 установок
- [frontend-design](https://affpapa.org/nevibecode/skills/frontend-design.md) — скилл · 1025790 установок
- [grill-me](https://affpapa.org/nevibecode/skills/grill-me.md) — скилл · 1424476 установок
- [grill-with-docs](https://affpapa.org/nevibecode/skills/grill-with-docs.md) — скилл · 1219756 установок
- [improve-codebase-architecture](https://affpapa.org/nevibecode/skills/improve-codebase-architecture.md) — скилл · 1163035 установок
- [design-taste-frontend](https://affpapa.org/nevibecode/skills/design-taste-frontend.md) — скилл · 678700 установок

Из того же набора: [davila7/claude-code-templates](https://affpapa.org/nevibecode/by/davila7/claude-code-templates.md) — 495 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md