# sync-skills-readme

Команда sync-skills-readme для Claude Code собирает список скиллов из skills/ и обновляет таблицу «Available Skills» в корневом README.md. Запускается при изменении каталога скиллов.

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

## Что делает

Команда сканирует `skills/`, читает из каждого `SKILL.md` поля `name` и `description`, распределяет скиллы по категориям и формирует компактную таблицу. Длинные описания сокращаются. В таблице остаются ссылки на README каждого скилла.

Затем команда заменяет содержимое раздела «Available Skills», не затрагивая остальные разделы README. Для работы используются Bash, Read и Edit; Grep применять не нужно. Если у скилла нет `SKILL.md` или нужных полей, он пропускается с предупреждением. Если раздела «Available Skills» нет, команда останавливается с ошибкой — README потребуется проверить вручную.

## Установка

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

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

### Codex

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

### GitHub Copilot

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

### Gemini CLI

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/softaworks/agent-toolkit/tree/HEAD/.claude/commands/sync-skills-readme.md

## Когда брать
- обновить таблицу скиллов после изменений в `skills/`
- собрать описания из frontmatter файлов `SKILL.md`
- распределить скиллы по категориям и отсортировать их
- сохранить остальные разделы корневого `README.md` без изменений

## Примеры запросов агенту
- Обнови таблицу Available Skills в корневом `README.md` по содержимому `skills/`.
- Пересобери список скиллов и проверь, что категории и описания соответствуют их `SKILL.md`.
- Синхронизируй таблицу скиллов в `README.md` с текущими папками в `skills/`.

## Похожие
- [readme-generator](https://affpapa.org/nevibecode/skills/jeremy-longshore-readme-generator.md) — скилл · 273 установки
- [create-readme-section](https://affpapa.org/nevibecode/commands/create-readme-section.md) — команда · ★ 2744 у репозитория
- [readme-updater](https://affpapa.org/nevibecode/skills/readme-updater.md) — скилл · ★ 788 у репозитория
- [indexion-readme](https://affpapa.org/nevibecode/skills/indexion-readme.md) — скилл · 5100 установок
- [create-readme](https://affpapa.org/nevibecode/skills/create-readme.md) — скилл · 19081 установка
- [readme-optimization](https://affpapa.org/nevibecode/skills/readme-optimization.md) — скилл · 13600 установок

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

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

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