---
title: "Генерация Agent Skills"
description: "Генерируйте Claude Agent Skills из локальных или удалённых репозиториев, чтобы AI-ассистенты могли повторно использовать ссылки на кодовую базу, структуру проекта и паттерны реализации."
---

# Генерация Agent Skills

Repomix может генерировать вывод в формате [Claude Agent Skills](https://docs.anthropic.com/en/docs/claude-code/skills), создавая структурированную директорию Skills, которая может использоваться как переиспользуемый справочник кодовой базы для ИИ-ассистентов.

Эта функция особенно мощная, когда вы хотите ссылаться на реализации из удалённых репозиториев. Генерируя Skills из open source проектов, вы можете легко попросить Claude ссылаться на конкретные паттерны или реализации при работе над вашим собственным кодом.

Вместо генерации одного упакованного файла, генерация Skills создаёт структурированную директорию с несколькими справочными файлами, оптимизированными для понимания ИИ и поиска grep-ом.

> [!NOTE]
> Это экспериментальная функция. Формат вывода и опции могут измениться в будущих версиях на основе отзывов пользователей.

## Базовое использование

Генерация Skills из локальной директории:

```bash
# Генерация Skills из текущей директории
repomix --skill-generate

# Генерация с пользовательским именем Skills
repomix --skill-generate my-project-reference

# Генерация из конкретной директории
repomix path/to/directory --skill-generate

# Генерация из удалённого репозитория
repomix --remote https://github.com/user/repo --skill-generate
```

## Выбор расположения Skills

При запуске команды Repomix предложит выбрать, куда сохранить Skills:

1. **Персональные Skills** (`~/.claude/skills/`) — Доступны во всех проектах на вашем компьютере
2. **Проектные Skills** (`.claude/skills/`) — Доступны вашей команде через git

Если директория Skills уже существует, вам будет предложено подтвердить перезапись.

> [!TIP]
> При генерации проектных Skills рассмотрите добавление их в `.gitignore`, чтобы избежать коммита больших файлов:
> ```gitignore
> .claude/skills/repomix-reference-*/
> ```

## Неинтерактивное использование

Для CI-конвейеров и скриптов автоматизации можно пропустить все интерактивные запросы с помощью `--skill-output` и `--force`:

```bash
# Указать директорию вывода напрямую (пропускает запрос выбора расположения)
repomix --skill-generate --skill-output ./my-skills

# Пропустить подтверждение перезаписи с --force
repomix --skill-generate --skill-output ./my-skills --force

# Полный неинтерактивный пример
repomix --remote user/repo --skill-generate my-skill --skill-output ./output --force
```

| Опция | Описание |
| --- | --- |
| `--skill-output <path>` | Указать путь директории вывода навыков напрямую (пропускает запрос расположения) |
| `-f, --force` | Пропустить все запросы подтверждения (например: перезапись директории навыков) |

## Генерируемая структура

Skills генерируются со следующей структурой:

```text
.claude/skills/<skill-name>/
├── SKILL.md                    # Основные метаданные и документация Skills
└── references/
    ├── summary.md              # Назначение, формат и статистика
    ├── project-structure.md    # Дерево директорий с количеством строк
    ├── files.md                # Всё содержимое файлов (удобно для grep)
    └── tech-stacks.md           # Языки, фреймворки, зависимости
```

### Описание файлов

| Файл | Назначение | Содержимое |
|------|-----------|-----------|
| `SKILL.md` | Основные метаданные и документация Skills | Имя Skills, описание, информация о проекте, количество файлов/строк/токенов, обзор использования, типичные сценарии использования и советы |
| `references/summary.md` | Назначение, формат и статистика | Описание справочной кодовой базы, документация структуры файлов, рекомендации по использованию, разбивка по типу файла и языку |
| `references/project-structure.md` | Обнаружение файлов | Дерево директорий с количеством строк на файл |
| `references/files.md` | Справочник кода с поиском | Всё содержимое файлов с заголовками подсветки синтаксиса, оптимизированное для поиска grep-ом |
| `references/tech-stacks.md` | Сводка технологического стека | Языки, фреймворки, версии рантайма, пакетные менеджеры, зависимости, конфигурационные файлы |

#### Пример: references/project-structure.md

```text
src/
  index.ts (42 lines)
  utils/
    helpers.ts (128 lines)
    math.ts (87 lines)
```

#### Пример: references/files.md

````markdown
## File: src/index.ts
```typescript
import { sum } from './utils/helpers';

export function main() {
  console.log(sum(1, 2));
}
```
````

#### Пример: references/tech-stacks.md

Автоматически определённый технологический стек из файлов зависимостей:
- **Языки**: TypeScript, JavaScript, Python и т.д.
- **Фреймворки**: React, Next.js, Express, Django и т.д.
- **Версии рантайма**: Node.js, Python, Go и т.д.
- **Пакетный менеджер**: npm, pnpm, poetry и т.д.
- **Зависимости**: Все прямые и dev-зависимости
- **Конфигурационные файлы**: Все обнаруженные файлы конфигурации

Определяется из файлов: `package.json`, `requirements.txt`, `Cargo.toml`, `go.mod`, `.nvmrc`, `pyproject.toml` и т.д.

## Автоматически генерируемые имена Skills

Если имя не указано, Repomix автоматически генерирует его по следующему паттерну:

```bash
repomix src/ --skill-generate                # → repomix-reference-src
repomix --remote user/repo --skill-generate  # → repomix-reference-repo
repomix --skill-generate CustomName          # → custom-name (нормализуется в kebab-case)
```

Имена Skills:
- Преобразуются в kebab-case (нижний регистр, разделены дефисами)
- Ограничены максимум 64 символами
- Защищены от обхода пути

## Интеграция с опциями Repomix

Генерация Skills учитывает все стандартные опции Repomix:

```bash
# Генерация Skills с фильтрацией файлов
repomix --skill-generate --include "src/**/*.ts" --ignore "**/*.test.ts"

# Генерация Skills со сжатием
repomix --skill-generate --compress

# Генерация Skills из удалённого репозитория
repomix --remote yamadashy/repomix --skill-generate

# Генерация Skills с конкретными опциями формата вывода
repomix --skill-generate --remove-comments --remove-empty-lines
```

### Skills только с документацией

Используя `--include`, вы можете генерировать Skills, содержащие только документацию из GitHub-репозитория. Это полезно, когда вы хотите, чтобы Claude ссылался на конкретную документацию библиотеки или фреймворка при работе над вашим кодом:

```bash
# Документация Claude Code Action
repomix --remote https://github.com/anthropics/claude-code-action --include docs --skill-generate

# Документация Vite
repomix --remote https://github.com/vitejs/vite --include docs --skill-generate

# Документация React
repomix --remote https://github.com/reactjs/react.dev --include src/content --skill-generate
```

## Ограничения

Опция `--skill-generate` не может использоваться с:
- `--stdout` — Вывод Skills требует записи в файловую систему
- `--copy` — Вывод Skills — это директория, которую нельзя скопировать в буфер обмена

## Использование сгенерированных Skills

После генерации вы можете использовать Skills с Claude:

1. **Claude Code**: Skills автоматически доступны, если сохранены в `~/.claude/skills/` или `.claude/skills/`
2. **Claude Web**: Загрузите директорию Skills в Claude для анализа кодовой базы
3. **Командное использование**: Закоммитьте `.claude/skills/` в ваш репозиторий для доступа всей команды

## Пример рабочего процесса

### Создание персональной справочной библиотеки

```bash
# Клонировать и проанализировать интересный open source проект
repomix --remote facebook/react --skill-generate react-reference

# Skills сохранены в ~/.claude/skills/react-reference/
# Теперь вы можете ссылаться на кодовую базу React в любом разговоре с Claude
```

### Документация для команды проекта

```bash
# В директории вашего проекта
cd my-project

# Генерация Skills для вашей команды
repomix --skill-generate

# Выберите "Project Skills" при запросе
# Skills сохранены в .claude/skills/repomix-reference-my-project/

# Закоммитьте и поделитесь с командой
git add .claude/skills/
git commit -m "Add codebase reference Skills"
```

## Связанные ресурсы

- [Плагины Claude Code](/ru/guide/claude-code-plugins) — Узнайте о плагинах Repomix для Claude Code
- [MCP-сервер](/ru/guide/mcp-server) — Альтернативный метод интеграции
- [Сжатие кода](/ru/guide/code-compress) — Уменьшение количества токенов со сжатием
- [Конфигурация](/ru/guide/configuration) — Настройка поведения Repomix
