setup-ralph — скилл для Claude Code: петля Ralph и установка
Скилл setup-ralph разворачивает автономную петлю Ralph Wiggum в любом каталоге: раскладку файлов, промпты планирования и сборки, проверки, которые отбраковывают слабый результат.
MIT ★ 1 988 обновлён 2026-04-01
/plugin marketplace add glittercowboy/taches-cc-resources
/plugin install taches-cc-resources@taches-cc-resourcesЧто делает setup-ralph
Скилл настраивает петлю Ralph Wiggum: while :; do cat PROMPT.md | claude ; done. Агент берёт одну задачу из плана, доводит её, коммитит и выходит, а цикл запускается заново с чистым контекстом. Работа делится на три фазы: планирование (сравнить спеки с кодом и получить список задач), сборка, наблюдение за петлёй.
При запуске скилл спрашивает, что нужно: новая петля, разбор методики, правка промптов или отладка. Дальше он открывает соответствующий файл в workflows/ и идёт по шагам. Справочники лежат в references/: устройство проекта, дизайн промптов, стратегия проверок, заметки по эксплуатации.
Отбраковка держится на тестах, тайпчеках, линтах и сборке. Автобэкап в приватный репозиторий требует авторизованного gh CLI, без него копии не будет — тогда бэкап выключают через RALPH_BACKUP=false. В PROMPT_build.md прописаны запреты на опасные операции вроде rm -rf по каталогам проекта, а тесты должны идти в изолированных временных каталогах.
Какие задачи решает
- развернуть структуру петли Ralph в новом каталоге
- получить список задач из расхождения между спеками и кодом
- настроить отбраковку через тесты, линты и сборку
- переписать промпты планирования и сборки под свой проект
- разобраться, почему петля встала, и поправить конфигурацию
Примеры запросов агенту
- Разверни новую петлю Ralph в этом проекте через setup-ralph.
- Покажи, как устроена методика Ralph и что делает каждая фаза.
- Поправь промпты в существующей петле: планирование выходит слишком расплывчатым.
Как установить setup-ralph
1Через маркетплейс плагинов
/plugin marketplace add glittercowboy/taches-cc-resources/plugin install taches-cc-resources@taches-cc-resourcesКоманда ставит плагин taches-cc-resources целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add glittercowboy/taches-cc-resources --skill setup-ralph -a claude-code3Вручную: положить файлы
~/.claude/skills/setup-ralph/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/setup-ralph/
1Через Skills CLI (Vercel)
npx skills add glittercowboy/taches-cc-resources --skill setup-ralph -a codex2Вручную: положить файлы
.agents/skills/setup-ralph/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add glittercowboy/taches-cc-resources --skill setup-ralph -a cursor2Вручную: положить файлы
.cursor/skills/setup-ralph/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install glittercowboy/taches-cc-resources skills/setup-ralph2Вручную: положить файлы
.github/skills/setup-ralph/SKILL.md1Через Skills CLI (Vercel)
npx skills add glittercowboy/taches-cc-resources --skill setup-ralph -a gemini-cli2Командой платформы
gemini skills install https://github.com/glittercowboy/taches-cc-resources --path skills/setup-ralphВручную: положить файлы
.devin/skills/setup-ralph/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о setup-ralph
Как установить setup-ralph в Claude Code?
Через маркетплейс: сначала /plugin marketplace add glittercowboy/taches-cc-resources, потом /plugin install taches-cc-resources@taches-cc-resources.
Что делает setup-ralph?
Настраивает автономную петлю Ralph Wiggum в каталоге: раскладку файлов, промпты для планирования и сборки, правила отбраковки. Отдельно есть режимы разбора методики, кастомизации и отладки.
Зачем петле авторизованный gh CLI?
После каждого коммита она пушит копию в приватный репозиторий GitHub, чтобы автономная работа не унесла данные. Ненужный бэкап выключается переменной RALPH_BACKUP=false.
Исходный текст
SKILL.md · MIT
--- name: setup-ralph description: Set up and configure Geoffrey Huntley's original Ralph Wiggum autonomous coding loop in any directory with proper structure, prompts, and backpressure. --- <essential_principles> ## What is Ralph? Ralph is Geoffrey Huntley's autonomous AI coding methodology that uses iterative loops with task selection, execution, and validation. In its purest form, it's a Bash loop: ```bash while :; do cat PROMPT.md | claude ; done ``` The loop feeds a prompt file to Claude, the agent completes one task, updates the implementation plan, commits changes, then exits. The loop restarts immediately with fresh context. ### Core Philosophy **The Ralph Wiggum Technique is deterministically bad in an undeterministic world.** Ralph solves context accumulation by starting each iteration with fresh context—the core insight behind Geoffrey's approach. ### Three Phases, Two Prompts, One Loop 1. **Planning Phase**: Gap analysis (specs vs code) outputs prioritized TODO list—no implementation, no commits 2. **Building Phase**: Picks tasks from plan, implements, runs tests (backpressure), commits 3. **Observation Phase**: You sit on the loop, not in it—engineer the setup and environment that allows Ralph to succeed ### Key Principles **Your Role**: Ralph does all the work, including deciding which planned work to implement next and how to implement it. Your job is to engineer the environment. **Backpressure**: Create backpressure via tests, typechecks, lints, builds that reject invalid/unacceptable work. **Observation**: Watch, especially early on. Prompts evolve through observed failure patterns. **Context Efficiency**: With ~176K usable tokens from 200K window, allocating 40-60% to "smart zone" means tight tasks with one task per loop achieves maximum context utilization. **File I/O as State**: The plan file persists between isolated loop executions, serving as deterministic shared state—no sophisticated orchestration needed. **Remote Backup**: The loop automatically creates a private GitHub repo and pushes after each commit. This protects against accidental data loss from autonomous operations. Requires `gh` CLI authenticated. Disable with `RALPH_BACKUP=false`. **Safety Rules**: PROMPT_build.md includes critical safety rules prohibiting dangerous operations like `rm -rf` on project directories. Tests must run in isolated temp directories. </essential_principles> <intake> What would you like to do? 1. **Set up a new Ralph loop** - Initialize Ralph structure in a directory 2. **Understand Ralph concepts** - Learn about the technique and how it works 3. **Customize existing loop** - Modify prompts or configuration 4. **Troubleshoot Ralph** - Debug loop issues or improve performance Wait for response before proceeding. </intake> <routing> | Response | Workflow | |----------|----------| | 1, "set up", "setup", "new", "initialize", "create" | `workflows/setup-new-loop.md` | | 2, "understand", "learn", "concepts", "explain", "how" | `workflows/understand-ralph.md` | | 3, "customize", "modify", "change", "update", "edit" | `workflows/customize-loop.md` | | 4, "troubleshoot", "debug", "fix", "problem", "issue" | `workflows/troubleshoot-loop.md` | | Other | Clarify intent, then select appropriate workflow | After reading the workflow, follow it exactly. </routing> <reference_index> ## Domain Knowledge All in `references/`: **Core Concepts:** ralph-fundamentals.md - Three phases, two prompts, one loop **Structure:** project-structure.md - Required files and directory layout **Prompts:** prompt-design.md - Planning vs building mode instructions **Backpressure:** validation-strategy.md - Tests, lints, builds as steering **Best Practices:** operational-learnings.md - AGENTS.md guidance and evolution </reference_index> <workflows_index> | Workflow | Purpose | |----------|---------| | setup-new-loop.md | Initialize Ralph structure in a directory | | understand-ralph.md | Learn Ralph concepts and philosophy | | customize-loop.md | Modify prompts or loop configuration | | troubleshoot-loop.md | Debug loop issues and improve performance | </workflows_index> <success_criteria> Skill is successful when: - User understands which workflow they need - Appropriate workflow loaded based on intent - All required references loaded by workflow - User can set up and run Ralph loops independently </success_criteria>
© Lex Christopherson · MIT · glittercowboy/taches-cc-resources