# pragmatic-writing

Скилл задаёт агенту стиль технических текстов по мотивам «The Pragmatic Programmer» и «Joel on Software». Пригодится для статей, документации и туториалов.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 132
- Автор: robertguss
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/robertguss/claude-code-toolkit/tree/HEAD/plugins/compound-writing/skills/pragmatic-writing/SKILL.md
- Обновлён: 2026-09-16
- HTML: https://affpapa.org/nevibecode/skills/pragmatic-writing

## Что делает

Скилл включается, когда вы пишете технический текст: посты в блог, документацию, объяснения сложных тем для разработчиков, разборы «что мы поняли после инцидента». Агент перестаёт выдавать сухие определения и начинает с конкретного примера, а принцип выводит уже после него.

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

Скилл работает в Claude, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Ставится одной командой через `npx skills add`. Для GitHub Copilot путь другой — `gh skill install`. Стиль намеренно разговорный, с сокращениями и вопросами к читателю: если ваш редполитик требует сухого официального тона, этот скилл будет тянуть текст в другую сторону.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add robertguss/claude-code-toolkit --skill pragmatic-writing -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add robertguss/claude-code-toolkit --skill pragmatic-writing -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add robertguss/claude-code-toolkit --skill pragmatic-writing -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install robertguss/claude-code-toolkit pragmatic-writing
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add robertguss/claude-code-toolkit --skill pragmatic-writing -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/robertguss/claude-code-toolkit --path plugins/compound-writing/skills/pragmatic-writing
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add robertguss/claude-code-toolkit --skill pragmatic-writing -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/robertguss/claude-code-toolkit/tree/HEAD/plugins/compound-writing/skills/pragmatic-writing/SKILL.md

## Когда брать
- написать технический пост, который дочитают до конца
- объяснить сложную концепцию через бытовую аналогию
- собрать туториал с рабочими примерами кода
- переписать сухую документацию живым языком
- разобрать инцидент так, чтобы выводы запомнились

## Примеры запросов агенту
- Напиши пост в блог про внедрение очереди задач, стиль pragmatic-writing
- Объясни, зачем нужны миграции базы, в стиле pragmatic-writing
- Перепиши эту документацию по стилю pragmatic-writing, начни с примера

## Похожие
- [writing-clearly-and-concisely](https://affpapa.org/nevibecode/skills/writing-clearly-and-concisely.md) — скилл · 206 установок
- [writing-guidelines](https://affpapa.org/nevibecode/skills/writing-guidelines.md) — скилл · 107100 установок
- [llm-writing](https://affpapa.org/nevibecode/skills/llm-writing.md) — скилл · 742 установки
- [Writing Style Checker](https://affpapa.org/nevibecode/mcp/writing-style-checker.md) — MCP-сервер · ★ 9
- [avoid-ai-writing](https://affpapa.org/nevibecode/plugins/avoid-ai-writing.md) — плагин · ★ 41823
- [academic-writing](https://affpapa.org/nevibecode/skills/poemswe-academic-writing.md) — скилл · 1000 установок

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

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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