← Back to Skills Marketplace
78
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install nerua1-ralph
Description
Persistence loop until task completion with verification - "don't stop until it's done
Usage Guidance
This skill implements what it claims (a persistence loop that verifies completion) but there are several issues to consider before installing:
- Inconsistencies to check: README path (~/.claude/...) differs from SKILL.md (~/.openclaw/...). Confirm the intended install location and ownership before cloning or running scripts.
- Ambiguous agent interactions: the script references delegating to other agents and invokes an unexplained '/cancel' command. Ask the author what those do and how they interact with your agent runtime.
- File system and command execution: Ralph will create state under your home directory and run project commands (npm test/build, grep across your working tree). npm scripts can execute arbitrary code from the repository — run only in projects you trust or within an isolated environment.
- Long-running loops: the skill can iterate repeatedly (up to 10 times) performing builds/tests. Consider resource/time limits or running it in a sandbox (container/CI runner) rather than directly on your workstation.
- Source verification: the registry metadata lacks a verified homepage/source. If you plan to use it, inspect the GitHub repository the README points to (and review the full script) before cloning. Prefer running the script manually in a safe environment first.
If you need this capability, proceed after: verifying the repository, adjusting/confirming the install paths, running the script in an isolated sandbox the first time, and confirming the meaning and safety of the '/cancel' and 'delegate' behaviors.
Capability Analysis
Type: OpenClaw Skill
Name: nerua1-ralph
Version: 1.0.0
The 'ralph' skill is a persistence wrapper designed to ensure task completion through iterative verification (up to 10 attempts). It uses standard Bash scripting in SKILL.md to monitor project state, run tests (npm test), and check builds (npm run build). No evidence of data exfiltration, unauthorized persistence, or malicious prompt injection was found; the logic is transparent and includes safety limits (MAX_ITERATIONS) and user-override conditions ('cancel' or 'stop').
Capability Assessment
Purpose & Capability
Name/description match the implementation: a persistence loop that saves state and runs verification steps. However there are small incoherences: README suggests a clone path under ~/.claude/skills/... while the SKILL.md uses ~/.openclaw/... — inconsistent install locations/names. README also advertises a GitHub repo for install but the registry reported 'Source: unknown' and no homepage. These discrepancies suggest sloppy packaging or incomplete metadata.
Instruction Scope
The instructions and example script instruct the agent to read/write state under the user's home (~/.openclaw/state/ralph), run commands in the workspace (grep across files), and execute npm test/build if package.json exists. The skill also speaks of 'delegat[ing] to appropriate agents' and 'run long ops in background' — vague instructions that give the agent wide discretion. The script calls a '/cancel' command (unexplained) which may be an action intended to interact with the agent runtime; its behavior is ambiguous. These behaviors are coherent with a developer automation tool but broaden the agent's access to the filesystem and to executing arbitrary project scripts (npm scripts can run arbitrary code).
Install Mechanism
This is an instruction-only skill with no install spec or bundled binaries, which is low risk from install mechanics. README suggests cloning a GitHub repo (a normal pattern). No third-party downloads or extract steps are present in the registry metadata.
Credentials
The skill declares no required environment variables or credentials. Its requested access (read/write under the user's home and running local build/test commands) is proportionate to a tool that verifies builds/tests in a project. However, lack of declared requirements means the agent will rely on existing system tooling (npm, grep) which may execute project-provided code.
Persistence & Privilege
The skill writes persistent state to ~/.openclaw/state/ralph and suggests creating a script under ~/.openclaw/skills/ralph/ralph.sh (and README suggests an alternate path). always:false (not force-included) so it won't be auto-enabled for all agents, which is appropriate. Still, it will create files under the user's home and may run repeated long-running operations up to 10 iterations; users should be aware of disk/CPU/network implications.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install nerua1-ralph - After installation, invoke the skill by name or use
/nerua1-ralph - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Ralph skill v1.0.0 — Initial Release
- Introduces a "persistence loop" that keeps working on a task until fully complete and verified
- Implements multi-step verification: checks tests, build, TODOs, and quality before completion
- Caps at 10 iterations per task, with fresh evidence and state recorded for each attempt
- Provides clean exit on success, or marks as needs help if maximum iterations reached
- Includes clear guidelines for usage, example commands, integration instructions, and stop conditions
Metadata
Frequently Asked Questions
What is Ralph?
Persistence loop until task completion with verification - "don't stop until it's done. It is an AI Agent Skill for Claude Code / OpenClaw, with 78 downloads so far.
How do I install Ralph?
Run "/install nerua1-ralph" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Ralph free?
Yes, Ralph is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Ralph support?
Ralph is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Ralph?
It is built and maintained by nerua1 (@nerua1); the current version is v1.0.0.
More Skills