exo:ralph

Orchestrate iterative refinement loops for autonomous agents using RalphRunner.

1|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/midsphere-ai/exo --skill exo-ralph
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: exo:ralph
Source: https://github.com/midsphere-ai/exo/tree/main/skills/ralph
Command: npx skills add https://github.com/midsphere-ai/exo --skill exo-ralph

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Builds and orchestrates iterative refinement loops for autonomous agents using Ralph — RalphRunner, enabling a defined 5-phase cycle (Run/Analyze/Learn/Plan/Halt) with support for scorers, reflectors, stop conditions, and streaming events, plus integration points for Swarm via RalphNode.

Core Features & Use Cases

  • Orchestrates a 5-phase loop (Run, Analyze, Learn, Plan, Halt) using RalphRunner to manage execution, scoring, and feedback.
  • Provides from_agent() factory to wire an Agent's run and run.stream() into a Ralph loop for seamless integration.
  • Supports Swarm integration via RalphNode to embed refined loops into multi-agent workflows; streams RalphIterationEvent and RalphStopEvent for observability.
  • Configurable stop conditions, scoring and reflection, enabling quality-gated iterative improvements across iterations.

Quick Start

Provide an Agent, create a RalphRunner via from_agent with scorers and a stop condition, then call run to commence iterative refinement.

Frequently Asked Questions about exo:ralph

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up iterative refinement loops for autonomous agents?

You can wire an agent's run and stream methods into an iterative refinement loop using a factory function. This creates a runner that manages the 5-phase cycle and applies configured scorers and stop conditions for seamless integration.

Can I integrate iterative refinement into multi-agent swarm workflows?

Yes, you can embed refined loops into multi-agent swarm workflows using integration nodes. This allows the refinement cycle to operate within a broader swarm architecture while streaming iteration and stop events for observability.

How do I stop an autonomous agent's self-improvement loop?

Stop conditions and iteration limits control when the 5-phase cycle halts. You define scoring thresholds and maximum iteration counts to ensure the autonomous agent stops refining once quality goals are achieved.

What is the difference between scorers and reflectors in agent loops?

Scorers evaluate output quality to gate improvements, while reflectors generate feedback for re-prompting during the Learn phase. Both are optional configurable components that enable autonomous agents to self-improve across iterations.

How do I get visibility into an autonomous agent's refinement progress?

Visibility into refinement progress is achieved through streaming events. The loop emits iteration and stop events during execution, providing real-time observability of the Run, Analyze, Learn, Plan, and Halt phases as they occur.

Do I need specific dependencies to run iterative refinement loops?

A runner is required to execute the 5-phase cycle, while scorers, reflectors, and swarm integration nodes are optional. The runner can be created from an existing agent's run and stream methods without additional dependencies.