# coding-guidelines

Скилл задаёт поведенческие правила для агента при написании и рефакторинге кода. Он снижает число типичных ошибок нейросетей, отдавая приоритет аккуратности перед скоростью.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 322 установки · ★ 7089
- Автор: ale
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/tech-leads-club/agent-skills/tree/HEAD/packages/skills-catalog/skills/(development)/coding-guidelines/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/ale-coding-guidelines

## Что делает

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

В основе лежит принцип точечных изменений. Модель не имеет права трогать соседний код, форматирование или добавлять абстракции про запас. Если код на 200 строк можно сократить до 50, скилл требует переписать его проще.

Инструкции рассчитаны строго на программирование, исправление ошибок и ревью. Для проектирования общей архитектуры или составления документации скилл прямо не предназначен.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tech-leads-club/agent-skills --skill coding-guidelines -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tech-leads-club/agent-skills --skill coding-guidelines -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tech-leads-club/agent-skills --skill coding-guidelines -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install tech-leads-club/agent-skills coding-guidelines
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tech-leads-club/agent-skills --skill coding-guidelines -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/tech-leads-club/agent-skills --path 'packages/skills-catalog/skills/(development)/coding-guidelines'
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add tech-leads-club/agent-skills --skill coding-guidelines -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/tech-leads-club/agent-skills/tree/HEAD/packages/skills-catalog/skills/(development)/coding-guidelines/SKILL.md

## Когда брать
- Ограничить правки только запрошенными файлами и строками без лишнего рефакторинга
- Заставить агента писать воспроизводящий тест перед исправлением бага
- Избавиться от лишних абстракций и избыточных проверок в одноразовом коде
- Выявлять скрытые компромиссы и задавать вопросы до начала генерации кода

## Примеры запросов агенту
- Используй coding-guidelines и исправь утечку памяти в воркере фоновых задач
- Примени coding-guidelines при рефакторинге модуля авторизации, сохранив старые тесты
- Проведи ревью этого пуллреквеста по правилам coding-guidelines

## Похожие
- [cpp-coding-standards](https://affpapa.org/nevibecode/skills/cpp-coding-standards.md) — скилл · 5100 установок
- [karpathy-guidelines](https://affpapa.org/nevibecode/skills/karpathy-guidelines.md) — скилл · 42700 установок
- [rust-skills](https://affpapa.org/nevibecode/skills/rust-skills.md) — скилл · 6500 установок
- [ce-simplify-code](https://affpapa.org/nevibecode/skills/ce-simplify-code.md) — скилл · 3400 установок
- [blast-radius](https://affpapa.org/nevibecode/skills/michael-denyer-blast-radius.md) — скилл · 889 установок
- [refactor](https://affpapa.org/nevibecode/skills/parcadei-refactor.md) — скилл · 621 установка

## Другие версии с тем же именем
- [coding-guidelines · actionbook](https://affpapa.org/nevibecode/skills/coding-guidelines.md) — 4000 установок

Из того же набора: [tech-leads-club/agent-skills](https://affpapa.org/nevibecode/by/tech-leads-club/agent-skills.md) — 11 карточек

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

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