# ralph-docs

Скилл учит агента искать ответы о Ralph Orchestrator в опубликованной карте документации, а не выдумывать их по памяти. Пригодится, когда нужно разобраться в устройстве фреймворка или спланировать правку в его репозитории.

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

## Что делает

Скилл подключает агента к карте документации `llms.txt` проекта ralph-orchestrator. Сначала агент забирает саму карту, выбирает одну-три страницы под вопрос, скачивает их в формате `.md` и отвечает уже по ним. Кэш лежит в `~/.cache/ralph-docs/`, карта считается свежей 7 дней, потом её перезапрашивают.

Внутри три справочника: `references/llms-txt-map.md` с разделами карты, `references/common-questions.md` с частыми вопросами и `references/contributing.md` про порядок правок и раскладку крейтов. Разделение ролей чёткое: создание и правка пользовательских hats — это скилл ralph-hats, работа с живым циклом (запуск, возобновление, слияние, отладка) — ralph-loop, а ralph-docs только объясняет и очерчивает объём изменений.

Для работы нужен `curl` — им тянутся страницы, если у агента нет своего инструмента веб-загрузки. Есть и подводный камень: документация может оказаться новее установленной версии Ralph, тогда скилл советует сверить `ralph --version` и решить, чему верить. Для запросов «как улучшить Ralph» сначала читается `concepts/tenets/index.md` — шесть принципов проекта, и правка, которая им противоречит, скорее всего должна жить в другом месте.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mikeyobrien/ralph-orchestrator --skill ralph-docs -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mikeyobrien/ralph-orchestrator --skill ralph-docs -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mikeyobrien/ralph-orchestrator --skill ralph-docs -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install mikeyobrien/ralph-orchestrator ralph-docs
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mikeyobrien/ralph-orchestrator --skill ralph-docs -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/mikeyobrien/ralph-orchestrator --path skills/ralph-docs
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add mikeyobrien/ralph-orchestrator --skill ralph-docs -a opencode
```

### Claude.ai

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

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

## Когда брать
- объяснить, почему цикл завершился по max_iterations
- найти нужный крейт и тесты перед правкой ralph-orchestrator
- разобрать, почему не сработал hat
- сопоставить симптом бага с подсистемой и файлом в репозитории
- ответить новичку на вопросы по установке из официальных страниц

## Примеры запросов агенту
- Как в Ralph устроен event loop и где это описано в документации?
- Почему мой цикл завершился по max_iterations — найди объяснение в доках
- Хочу поменять поведение presets: какой крейт и какие тесты затрагиваются?

## Похожие
- [coding-agent-docs-optimization](https://affpapa.org/nevibecode/skills/coding-agent-docs-optimization.md) — скилл · 10300 установок
- [dd-docs](https://affpapa.org/nevibecode/skills/dd-docs.md) — скилл · 1800 установок
- [create-llms](https://affpapa.org/nevibecode/skills/create-llms.md) — скилл · 9200 установок
- [update-llms](https://affpapa.org/nevibecode/skills/update-llms.md) — скилл · 8800 установок
- [llms](https://affpapa.org/nevibecode/commands/llms.md) — команда · ★ 3149
- [Documentation Extractor](https://affpapa.org/nevibecode/mcp/documentation-extractor.md) — MCP-сервер · ★ 35

Из того же набора: [mikeyobrien/ralph-orchestrator](https://affpapa.org/nevibecode/by/mikeyobrien/ralph-orchestrator.md) — 10 карточек

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

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