# sync-agents-md

Команда sync-agents-md перегенерирует AGENTS.md из CLAUDE.md, чтобы документация для Codex CLI не отставала от конфигурации проекта. Полезно после правок конфига или добавления скилла.

- команда · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 907 у репозитория
- Автор: alirezarezvani
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/alirezarezvani/claude-code-skill-factory/tree/HEAD/.claude/commands/sync-agents-md.md
- Обновлён: 2025-11-12
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/commands/sync-agents-md

## Что делает

Команда перегенерирует `AGENTS.md` из `CLAUDE.md` через скилл codex-cli-bridge. Сначала проверяет, что Codex CLI установлен и файл `CLAUDE.md` лежит в проекте, потом разбирает структуру: сколько скиллов в `.claude/skills/`, сколько субагентов в `.claude/agents/`, какие разделы есть в конфиге. На выходе `AGENTS.md` перезаписывается целиком.

Обновляются обзор проекта, список скиллов с примерами для Codex CLI, дерево папок, паттерны воркфлоу и таблица соответствия слэш-команд. Флаги меняют поведение: `--validate` только проверяет окружение и ничего не пишет, `--status` показывает дату последней синхронизации и перечень задокументированных скиллов и агентов.

Codex CLI нужен на первом шаге — без него команда останавливается с ошибкой, и `AGENTS.md` останется старым. Править `AGENTS.md` руками нет смысла: следующая синхронизация его перезапишет. Источник правды тут `CLAUDE.md`.

## Установка

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

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

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/sync-agents-md.md` — Вызов — /prompts:sync-agents-md. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/prompts/sync-agents-md.prompt.md`

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/sync-agents-md.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/alirezarezvani/claude-code-skill-factory/tree/HEAD/.claude/commands/sync-agents-md.md

## Когда брать
- Обновить `AGENTS.md` после правок в `CLAUDE.md`
- Добавить новый скилл в документацию для Codex CLI
- Проверить окружение перед генерацией, не трогая файл
- Посмотреть, когда `AGENTS.md` синхронизировали в последний раз
- Поймать рассинхрон конфига до коммита

## Примеры запросов агенту
- Прогони `/sync-agents-md`, я поправил `CLAUDE.md` и хочу обновить документацию для Claude CLI.
- Проверь окружение без генерации: `/sync-agents-md --validate`.
- Покажи статус синхронизации: `/sync-agents-md --status`.

## Похожие
- [decision-doc-sync](https://affpapa.org/nevibecode/skills/decision-doc-sync.md) — скилл · 5700 установок
- [sync](https://affpapa.org/nevibecode/skills/sync.md) — скилл · 5000 установок
- [audit](https://affpapa.org/nevibecode/skills/jsmastery-pro-audit.md) — скилл · 5100 установок
- [index-knowledge](https://affpapa.org/nevibecode/skills/index-knowledge.md) — скилл · 1300 установок
- [deepinit](https://affpapa.org/nevibecode/skills/deepinit.md) — скилл · 1100 установок
- [agent-rules](https://affpapa.org/nevibecode/skills/agent-rules.md) — скилл · 850 установок

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

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

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