# claude-md

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

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

## Что делает

Скилл работает в трёх режимах: `create` пишет `CLAUDE.md` с нуля, `update` чистит существующий, `audit` только отчитывается о качестве и файл не трогает. Можно указать путь вроде `src/api/CLAUDE.md`, если нужны отдельные инструкции для каталога.

Внутри — разбор проекта: стек, тип репозитория, инструменты сборки и тестов, затем чтение `README.md`, `CONTRIBUTING.md`, `package.json` и подобных файлов. Дальше содержимое собирается по схеме «что, зачем, как»: стек и структура, назначение компонентов, команды разработки и неочевидные подводные камни. Для больших проектов скилл советует вынести детали в папку `agent_docs/` и ссылаться на файлы через `file:line`, а не вставлять куски кода.

Ограничение жёсткое: целевая длина — до 200 строк, и лучше меньше. Стилевые правила, линтеры и инструкции под конкретную задачу из файла убираются, потому что они раздувают контекст и мешают агенту следовать остальным указаниям. Черновик скилл сначала показывает на ревью и пишет файл только после подтверждения. Отдельно разбирается `AGENTS.md`: в свежих версиях Claude читает его напрямую, но лишь когда ни в рабочем каталоге, ни выше нет `CLAUDE.md`, `.claude/CLAUDE.md` или `CLAUDE.local.md`; иначе остаётся импорт через `@AGENTS.md` или симлинк. Если у вас старая версия или первый запуск после обновления, рассчитывайте на запасной путь.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add luongnv89/claude-howto --skill claude-md -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add luongnv89/claude-howto --skill claude-md -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add luongnv89/claude-howto --skill claude-md -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install luongnv89/claude-howto claude-md
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add luongnv89/claude-howto --skill claude-md -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/luongnv89/claude-howto --path 03-skills/claude-md
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add luongnv89/claude-howto --skill claude-md -a opencode
```

### Claude.ai

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

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

## Когда брать
- собрать `CLAUDE.md` с нуля под конкретный репозиторий
- вычистить из файла стилевые правила и куски кода
- сократить раздутые инструкции до пары сотен строк
- проверить качество текущего `CLAUDE.md` без правок
- вынести детали в `agent_docs/` и сослаться на них

## Примеры запросов агенту
- создай CLAUDE.md для этого проекта
- обнови CLAUDE.md и убери из него всё про форматирование
- проведи аудит CLAUDE.md и покажи отчёт

## Похожие
- [agents-md](https://affpapa.org/nevibecode/skills/agents-md.md) — скилл · 7100 установок
- [ensure-agents-md](https://affpapa.org/nevibecode/skills/ensure-agents-md.md) — скилл · 1100 установок
- [memorize](https://affpapa.org/nevibecode/skills/memorize.md) — скилл · 1300 установок
- [bmad-project-context](https://affpapa.org/nevibecode/skills/bmad-project-context.md) — скилл · 11500 установок
- [sync](https://affpapa.org/nevibecode/skills/sync.md) — скилл · 4300 установок
- [audit](https://affpapa.org/nevibecode/skills/jsmastery-pro-audit.md) — скилл · 4300 установок

## Другие версии с тем же именем
- [claude-md · luongnv89](https://affpapa.org/nevibecode/skills/luongnv89-claude-md.md) — ★ 45153

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

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

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