# writing-lean

Скилл writing-lean для Claude Code помогает писать ясный код и короткие тексты для проекта. Включается при работе с комментариями, документацией и сообщениями в GitHub.

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

## Что делает

Скилл задаёт правила для кода и текстов вокруг него: сначала уточнить имя, упростить функцию или спецификацию, а не добавлять объяснения. Для одного понятия он предлагает выбирать термин из проекта и использовать его последовательно. Коротко и по делу.

Комментарии нужны для ограничений, ловушек и неочевидных причин; README описывает основной путь, а историю решений предлагают оставлять в issue, pull request или commit. Для каждой фразы действует проверка: что потеряет читатель, если её удалить? Если ничего, фраза лишняя. Ссылку на issue в коде скилл предлагает добавлять, только когда она влияет на будущие изменения.

Чтобы установить в Claude Code, выполните `npx skills add clhbid/agent-context --skill writing-lean -a claude-code`; файл скилла находится по пути `~/.claude/skills/writing-lean/SKILL.md`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill writing-lean -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill writing-lean -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill writing-lean -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install clhbid/agent-context skills/writing-lean
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill writing-lean -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/clhbid/agent-context --path skills/writing-lean
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill writing-lean -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/clhbid/agent-context/tree/HEAD/skills/writing-lean/SKILL.md

## Когда брать
- сократить комментарии, которые повторяют код
- выбрать единый термин для понятия в проекте
- разнести контекст между README, issue и pull request
- оформить review-комментарий с одним замечанием и исправлением

## Примеры запросов агенту
- Сократи комментарии в этом файле, оставив только ограничения и неочевидные причины.
- Отредактируй README: оставь основной путь использования и ссылки на следующие шаги.
- Сформулируй сообщение для pull request: что изменилось и почему.

## Похожие
- [review-ai-writing](https://affpapa.org/nevibecode/skills/review-ai-writing.md) — скилл · 119 установок
- [lean-comments](https://affpapa.org/nevibecode/skills/lean-comments.md) — скилл · 17 установок
- [llm-writing](https://affpapa.org/nevibecode/skills/haowjy-llm-writing.md) — скилл · 815 установок
- [grounded-writing](https://affpapa.org/nevibecode/skills/grounded-writing.md) — скилл · 660 установок
- [ux-writing](https://affpapa.org/nevibecode/skills/scarletkc-ux-writing.md) — скилл · ★ 229 у репозитория
- [writing-lean-proofs](https://affpapa.org/nevibecode/skills/writing-lean-proofs.md) — скилл · 1800 установок

Из того же набора: [clhbid/agent-context](https://affpapa.org/nevibecode/by/clhbid/agent-context.md) — 8 карточек

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