headroom/.opencode/skills/open-ralph-wiggum/SKILL.md

name, description, license, compatibility, metadata

name	description	license	compatibility	metadata
open-ralph-wiggum	Run autonomous Ralph loops in the current repository using OpenCode as the default agent.	MIT	Requires Node.js/npm and OpenCode CLI configured with a working model.	author source th0rgal https://github.com/Th0rgal/open-ralph-wiggum

Use Open Ralph Wiggum to run repeatable autonomous coding loops from OpenCode.

Input: The user message after this skill should include the task prompt for Ralph. Optional Ralph flags can be passed as part of the message.

Steps

1. Validate a task prompt exists

   If no task prompt is provided, ask for one clear prompt and stop.

2. Ensure Ralph CLI is available in this repo

   Run:

   npm install --prefix ".opencode" @th0rgal/ralph-wiggum
   

3. Run Ralph with OpenCode agent (default)

   Use local binary via npx so no global install is required:

   npx --prefix ".opencode" ralph "<user prompt>" --agent opencode --max-iterations 10
   

   If the user already included --max-iterations, keep their value.

4. Report result and next controls

   Mention how to monitor or steer loop if still running:

   • npx --prefix ".opencode" ralph --status
   • npx --prefix ".opencode" ralph --add-context "<hint>"

Guardrails

• Do not register Ralph as an OpenCode plugin. It is a CLI wrapper, not a plugin.
• Keep execution in the current repository.
• Do not use unlimited iterations by default; always set --max-iterations unless user explicitly asks otherwise.