# skill-writing-guide

Скилл skill-writing-guide помогает создавать и полировать новые скиллы для Claude Code. Он превращает удачные цепочки диалога в готовый файл конфигурации.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 165 у репозитория
- Автор: aspi6246
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/aspi6246/Claude-Code-Skills-for-Academics/tree/HEAD/skill-writing-guide/SKILL.md
- Обновлён: 2026-08-21
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/skill-writing-guide

## Что делает

Этот скилл работает как справочник по созданию модулей для Claude Code. Когда вы просите зафиксировать процесс или оформить разговор в отдельный навык, агент опирается на структуру `SKILL.md` с YAML-шапкой. Внутри описаны правила организации каталогов с кодом в `scripts/`, документацией в `references/` и шаблонами в `assets/`.

Основной упор сделан на формулировку блока `description`, по которому среда принимает решение о запуске навыка. Скилл учит задавать чёткие запреты через слова «always» и «never», а также добавлять конкретный код вместо общих инструкций. Если файл `SKILL.md` разрастается длиннее 200 строк, справочник требует выносить объёмные тексты во вложенную папку `references/`.

Без продуманных примеров Claude часто игнорирует общие правила. Поэтому руководство советует сразу вписывать в тело навыка типичные правки из диалогов, которые приходилось повторять от трёх раз.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aspi6246/Claude-Code-Skills-for-Academics --skill skill-writing-guide -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aspi6246/Claude-Code-Skills-for-Academics --skill skill-writing-guide -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aspi6246/Claude-Code-Skills-for-Academics --skill skill-writing-guide -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aspi6246/Claude-Code-Skills-for-Academics skill-writing-guide
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aspi6246/Claude-Code-Skills-for-Academics --skill skill-writing-guide -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/aspi6246/Claude-Code-Skills-for-Academics --path skill-writing-guide
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/aspi6246/Claude-Code-Skills-for-Academics/tree/HEAD/skill-writing-guide/SKILL.md

## Когда брать
- сформировать правильную структуру папок и файл `SKILL.md`
- составить точный триггер в блоке `description` для надёжного вызова
- зафиксировать жёсткие запреты и примеры кода вместо абстрактных инструкций
- разбить слишком длинную инструкцию на основной файл и подпапку со справочниками

## Примеры запросов агенту
- Сохрани этот рабочий процесс как отдельный скилл
- Сделай из нашего диалога скилл для работы со скриптами анализа данных
- Помоги улучшить описание и правила в моём `SKILL.md`

## Похожие
- [writing-skills](https://affpapa.org/nevibecode/skills/pedro-nauck-writing-skills.md) — скилл · 338 установок
- [writing-agents-md](https://affpapa.org/nevibecode/skills/writing-agents-md.md) — скилл · 305 установок
- [writing-principles](https://affpapa.org/nevibecode/skills/writing-principles.md) — скилл · 1200 установок
- [om-spec-writing](https://affpapa.org/nevibecode/skills/om-spec-writing.md) — скилл · 3900 установок
- [h3-prompt-writing](https://affpapa.org/nevibecode/skills/h3-prompt-writing.md) — скилл · 13200 установок
- [writing-staffing](https://affpapa.org/nevibecode/skills/writing-staffing.md) — скилл · 787 установок

Из того же набора: [aspi6246/claude-code-skills-for-academics](https://affpapa.org/nevibecode/by/aspi6246/claude-code-skills-for-academics.md) — 17 карточек

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