К основному содержанию
команда CX Codex

sync-skills-readme — команда для Claude Code: обновляет README

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

MIT ★ 2 707 обновлён 2026-03-05

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/sync-skills-readme.md
Открыть на GitHub

Что делает sync-skills-readme

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

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

Какие задачи решает

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

Примеры запросов агенту

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

Как установить sync-skills-readme

Вручную: положить файлы

.claude/commands/sync-skills-readme.md

Вызов — /sync-skills-readme. Для всех проектов — ~/.claude/commands/

Вопросы о sync-skills-readme

Как установить sync-skills-readme в Claude Code?

Скопируйте файл команды в .claude/commands/sync-skills-readme.md.

Что делает sync-skills-readme?

Читает метаданные из skills/*/SKILL.md, сортирует скиллы по категориям и обновляет таблицу «Available Skills» в корневом README.md.

Что произойдёт, если в README нет раздела Available Skills?

Команда остановится с ошибкой. Если у отдельного скилла нет SKILL.md или полей name и description, этот скилл будет пропущен с предупреждением.

Исходный текст

sync-skills-readme.md · MIT
---
description: Sync root README.md with current skills inventory from skills/ directory
---

# Sync Skills README

Update the root README.md "Available Skills" table with all skills currently in the `skills/` directory. This command scans skills, reads their metadata, categorizes them, and regenerates the table.

## Workflow

### 1. Scan Skills Directory

Use Bash to list all skill directories:

```bash
ls -1 skills/
```

For each skill directory found, proceed to step 2.

### 2. Extract Skill Metadata

For each skill, read the SKILL.md frontmatter to extract:
- `name:` field (skill identifier)
- `description:` field (what the skill does)

Use the Read tool to read `skills/[skill-name]/SKILL.md` and extract the YAML frontmatter between the `---` markers.

**Example:**
```yaml
---
name: codex
description: Use when the user asks to run Codex CLI for code analysis...
---
```

Extract both fields for table generation.

### 3. Categorize Skills

Assign each skill to a category based on its purpose. Use this mapping:

| Category | Emoji | Keywords in name/description |
|----------|-------|------------------------------|
| AI Tools | 🤖 | codex, gemini, perplexity, ai, llm, model |
| Meta | 🔮 | command-creator, plugin-forge, plugin, command |
| Documentation | 📝 | docs, documentation, handoff, requirements, diagram, mermaid, draw, excalidraw, marp, slide, c4-architecture |
| Development | 🛠️ | session, handoff, entropy, development, workflow, database, dependency |
| Design & Frontend | 🎨 | design, frontend, ui, openapi, typescript, system |
| Utilities | 🔧 | domain, meme, web-to-markdown, utility, tool, datadog |
| Planning | 🎯 | plan, planning, spec, forge, gepetto, requirements, clarity, game-changing, features |
| Professional | 👔 | professional, communication, career, soft-skill, feedback, conversation |
| Testing | 🧪 | test, testing, qa, quality |
| Git | 📦 | commit, git, branch, pr, pull-request |

**Categorization logic:**
1. Check the skill name and description (case-insensitive)
2. Match against keywords in the table above
3. Assign to the first matching category
4. If no match, default to "Utilities" (🔧)

### 4. Generate Compact Table

Create a markdown table with this exact format:

```markdown
## 📚 Available Skills

| Category | Skill | Description |
|----------|-------|-------------|
| 🤖 AI Tools | [codex](skills/codex/README.md) | Advanced code analysis with GPT-5.2 |
| 🤖 AI Tools | [gemini](skills/gemini/README.md) | Large-scale review (200k+ context) |
...
```

**Table structure:**
- Column 1: Category emoji + name (e.g., "🤖 AI Tools")
- Column 2: Skill name as markdown link to its README
- Column 3: Short description (max ~50 chars, extracted from SKILL.md description field)

**Sorting:**
- Group by category (AI Tools first, then Meta, Documentation, Design & Frontend, Development, Planning, Professional, Testing, Git, Utilities last)
- Within each category, sort skills alphabetically by name

**Description shortening:**
- If description is longer than 50 characters, create a shortened version
- Keep it concise and action-oriented
- Examples:
  - "Use when the user asks to run Codex CLI for code analysis, refactoring, or automated editing" → "Advanced code analysis with GPT-5.2"
  - "Create comprehensive API handoff documentation for frontend developers after backend implementation" → "API handoff docs for frontend"

### 5. Update README.md

Use the Edit tool to replace the "Available Skills" section in the root README.md.

**Find and replace:**
1. Locate the section starting with `## 📚 Available Skills`
2. Find the end of the table (marked by the next `---` separator or next `##` heading)
3. Replace everything between those markers with the newly generated table

**Important:**
- Preserve the `---` separator after the table
- Do NOT modify other sections (Quick Navigation, Installation, etc.)
- Only replace the table content, keep the section heading

### 6. Report Results

After updating README.md, report to the user:

```
✅ README.md updated successfully

📊 Summary:
- Total skills: [count]
- Categories: [list of categories with counts]
- Skills added/updated: [list if any changes detected]

The Available Skills table in README.md now reflects all skills in the skills/ directory.
```

## Error Handling

**If a skill directory doesn't have SKILL.md:**
- Skip that skill
- Warn the user: "⚠️ Skipped [skill-name]: No SKILL.md found"

**If SKILL.md doesn't have required frontmatter:**
- Skip that skill
- Warn: "⚠️ Skipped [skill-name]: Missing name or description in frontmatter"

**If README.md section not found:**
- Error and stop: "❌ Could not find '## 📚 Available Skills' section in README.md"

## Tools to Use

- **Bash** - List skills directory
- **Read** - Read SKILL.md files for metadata extraction
- **Edit** - Update README.md with new table
- **DO NOT use Grep** - Read files directly for accurate frontmatter parsing

## Success Criteria

- All valid skills from skills/ directory appear in the table
- Skills are correctly categorized with appropriate emojis
- Table maintains compact format (3 columns)
- Descriptions are concise and readable
- README.md is updated without breaking other sections

© softaworks · MIT · softaworks/agent-toolkit

Похожие слэш-команды

Все слэш-команды по теме «Тексты и документация» →
readme-generator Jeremy Longshore Скилл для автоматической генерации README-файлов в проектах. Активируется по фразе «readme generator» или «readme» в запросе. CX Codex +1 273установок create-readme-section centminmod Команда create-readme-section для автоматической генерации структурированных секций README: установка, API, документация, вклад в проект. Экономит время на форматирование и соответствие best practices. CX Codex +1 ★ 2 744звёзд репо readme-updater alirezarezvani Скилл readme-updater обновляет README автоматически, когда меняется структура проекта, добавляются зависимости или новые фичи. CX Codex +1 ★ 788звёзд репо indexion-readme trkbt10 Скилл indexion-readme собирает README из шаблонов, doc-комментариев и статических файлов, а потом проверяет, что правки ничего не удалили. CX Codex +1 5 100установок create-readme официальный github Скилл create-readme для GitHub Copilot изучает проект и создаёт структурированный README.md. Собирает документацию по коду и файлам проекта. CX Codex +1 19 081установок readme-optimization Samuel Berthe Скилл readme-optimization для Claude Code и Codex анализирует README репозитория и переписывает его в посадочную страницу для разработчиков. Он проверяет команды запуска по коду и отсекает лишние бейджи. CX Codex +1 13 600установок

Из того же набора79

Весь набор →
communication-excellence-coach Субагент communication-excellence-coach разбирает черновики писем, калибрует тон общения и помогает отрепетировать сложные разговоры в режиме ролевой игры. CX Codex ★ 2 707звёзд репо sync-branch Синхронизирует фичу-ветку с последней версией main через rebase. Срабатывает по команде /sync-branch и обновляет PR через force-push. CX Codex +1 ★ 2 707звёзд репо compose-email Команда compose-email для составления профессиональных писем по методу What-Why-How. Задаёшь контекст — получаешь готовый черновик с правильной структурой, тоном и call-to-action. CX Codex +1 ★ 2 707звёзд репо viral-tweet Команда viral-tweet превращает черновую идею в пост для сети X с расчётом на метрики вовлечения алгоритма рекомендаций. CX Codex +1 ★ 2 707звёзд репо explain-pr-changes Команда explain-pr-changes генерирует развёрнутое резюме pull request с визуализацией изменений. Помогает ревьюерам быстро разобраться в сути правок и их влиянии на архитектуру. CX Codex +1 ★ 2 707звёзд репо explain-changes-mental-model Команда explain-changes-mental-model раскладывает дифф на логические группы и подсказывает, в каком порядке их читать, чтобы коммит или ветка сложились в понятную картину. CX Codex +1 ★ 2 707звёзд репо add-skill Команда add-skill для копирования скилла в проект с проверкой названия и автогенерацией README. Сэкономит время на валидацию и документацию. CX Codex +1 ★ 2 707звёзд репо codex-plan Команда codex-plan собирает требования к задаче через уточняющие вопросы и готовит промпт для запуска планирования в gpt-5.2-codex. CX Codex +1 ★ 2 707звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой