ralph-loop — скилл для Claude Code: итерации до готовности
Скилл запускает цикл, в котором агент получает одну и ту же задачу заново после каждого хода и видит свою прошлую работу.
npx skills add cursor/plugins --skill ralph-loop -a claude-codeЧто делает ralph-loop
Ralph Loop — это режим, где один и тот же промпт возвращается агенту после каждого завершённого хода. Агент видит, что уже сделал в прошлых итерациях, и продолжает с того места, а не начинает заново. Пригодится, когда задача большая и за один проход не закрывается.
При запуске скилл создаёт каталог .cursor/ralph/ и файл .cursor/ralph/scratchpad.md с YAML-шапкой: номер итерации, лимит max_iterations и completion_promise. Ниже в файл ложится ваш промпт. Дальше цикл держит stop hook: он перехватывает конец хода и подкидывает тот же текст как followup-сообщение с пометкой [Ralph loop iteration N.].
max_iterations по умолчанию равен 0, то есть без ограничения. Автор советует задавать лимит как страховку. Выход из цикла — только через <promise>TEXT</promise>, и выводить его можно, когда условие выполнено по-настоящему. Если специальные символы в completion_promise, значение в шапке берите в кавычки.
Какие задачи решает
- довести большую задачу до конца за много проходов агента
- не терять контекст между итерациями одной работы
- задать условие остановки вместо бесконечного цикла
- ограничить число итераций, чтобы агент не крутился впустую
- запустить автономную доработку по одному промпту
Примеры запросов агенту
- Запусти Ralph loop: собери REST API для задач с CRUD, валидацией и тестами, максимум 20 итераций, обещание завершения COMPLETE
- Начни ralph loop для рефакторинга модуля оплаты, без лимита итераций
- Запусти итеративный цикл над задачей: починить падающие тесты в
tests/api, остановка по promise DONE
Как установить ralph-loop
1Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill ralph-loop -a claude-code2Вручную: положить файлы
~/.claude/skills/ralph-loop/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ralph-loop/
1Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill ralph-loop -a codex2Вручную: положить файлы
.agents/skills/ralph-loop/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill ralph-loop -a cursor2Вручную: положить файлы
.cursor/skills/ralph-loop/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install cursor/plugins ralph-loop2Вручную: положить файлы
.github/skills/ralph-loop/SKILL.md1Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill ralph-loop -a gemini-cli2Командой платформы
gemini skills install https://github.com/cursor/plugins --path ralph-loop/skills/ralph-loopВручную: положить файлы
.devin/skills/ralph-loop/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill ralph-loop -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о ralph-loop
Как установить ralph-loop в Claude Code?
Выполните npx skills add cursor/plugins --skill ralph-loop -a claude-code. Скилл встанет в ~/.claude/skills/ralph-loop/SKILL.md.
Что делает ralph-loop?
Заводит файл состояния .cursor/ralph/scratchpad.md с вашим промптом и параметрами, после чего stop hook возвращает тот же промпт агенту в конце каждого хода, пока не сработает условие остановки или лимит итераций.
Как цикл понимает, что пора остановиться?
По completion_promise: агент выводит <promise>TEXT</promise> только тогда, когда условие действительно выполнено. Ложные обещания ради выхода из цикла запрещены, а max_iterations работает как страховка.