mikeyobrien/ralph-orchestrator156 installs
ralph-loop
Operate Ralph loops: run, monitor, measure, resume, merge, debug. Use for `ralph run` or `ralph loops`, headless runs, A/B comparing hat collections, suspended loops, or merge queue issues.
How do I install this agent skill?
npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill ralph-loopIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides a set of commands and workflows for managing Ralph loops. It is generally safe but has a minor risk of indirect prompt injection as it processes logs and diagnostic files that may contain untrusted data.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
2/4 files flagged
What does this agent skill do?
Ralph Loop
Use this skill to operate Ralph loops from the outside.
Use This Skill For
- Starting or continuing a Ralph run with the right
-cand-Hinputs - Inspecting loop state, worktrees, logs, history, and diffs
- Resuming a hook-suspended loop
- Merging or discarding completed worktree loops
- Debugging unexpected loop behavior with current diagnostics files
- Running a loop headlessly, measuring its cost and iterations, or A/B comparing two hat collections
Workflow
- Start with
ralph loops listorralph loops list --jsonto establish the current state. - If the user wants execution, run
ralph run ...with the right core config and hats source. - If the loop is stuck or suspicious, inspect
logs,history, anddiffbefore changing state. - If the loop is suspended, read
.ralph/suspend-state.jsonand useralph loops resume <id>. - If a loop is queued or in
needs-review, inspect the diff first, then usemerge,process,retry, ordiscardas appropriate. - Use diagnostics when you need detailed evidence about hats, events, tool calls, parse errors, or performance.
- For an unattended run, or to report what a run did and cost, follow
references/headless-runs.md: isolate the workspace, launch with--autonomous, watch the events file, and measure from the run log.
Guardrails
- Prefer the CLI over direct edits to
.ralphstate files. - Treat tasks and memories as the canonical runtime systems; do not center scratchpad as the primary state model.
- Inspect diffs before merging.
- Only remove lock or queue artifacts when the underlying process is confirmed dead.
- Manual edits under
.ralph/are last-resort recovery steps and should be called out explicitly when used.
Read These References When Needed
- For command recipes and operator flows:
references/commands.md - For diagnostics files and suspend-state details:
references/diagnostics.md - For headless launch, monitoring, measuring, A/B comparison, and when to step in:
references/headless-runs.md
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/mikeyobrien/ralph-orchestrator/ralph-loop">View ralph-loop on skillZs</a>