# code-comments

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 599 установок · ★ 48
- Автор: petekp
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/petekp/claude-code-setup/tree/HEAD/skills/code-comments/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/code-comments

## Что делает

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

При ревью он по умолчанию ограничивает область комментариями из диффа, включая незакоммиченные изменения. Для чужого кода он выдаёт замечания вместо правок. Если изменение поведения функции необходимо, скилл просит указать символ и описать изменение отдельно. Это важно учитывать при чистке: поведение кода должно остаться прежним.

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

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add petekp/claude-code-setup --skill code-comments -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add petekp/claude-code-setup --skill code-comments -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add petekp/claude-code-setup --skill code-comments -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install petekp/claude-code-setup code-comments
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add petekp/claude-code-setup --skill code-comments -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/petekp/claude-code-setup --path skills/code-comments
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add petekp/claude-code-setup --skill code-comments -a opencode
```

### Claude.ai

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

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

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

## Примеры запросов агенту
- Проверь комментарии в текущем диффе и удали те, что не нужны.
- Просмотри комментарии в `src/api.ts` и сообщи, какие стоит оставить.
- Убери закомментированный код в изменённых файлах и перечисли удалённые TODO без задачи.

## Похожие
- [improve-codebase-architecture](https://affpapa.org/nevibecode/skills/improve-codebase-architecture.md) — скилл · 1163035 установок
- [tdd](https://affpapa.org/nevibecode/skills/tdd.md) — скилл · 1141062 установки
- [triage](https://affpapa.org/nevibecode/skills/triage.md) — скилл · 990453 установки
- [codebase-design](https://affpapa.org/nevibecode/skills/codebase-design.md) — скилл · 850344 установки
- [code-review](https://affpapa.org/nevibecode/skills/code-review.md) — скилл · 789521 установка
- [implement](https://affpapa.org/nevibecode/skills/implement.md) — скилл · 774700 установок

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

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