Agent skill
ralph-status
Display Ralph build status and progress. Use when user asks for "ralph status", "build status", "queue status", or wants to see subtask progress and iteration statistics.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/ralph-status
SKILL.md
Ralph Status
Display the current Ralph build status, including subtask progress, iteration statistics, and configuration state.
Usage
/ralph-status [subtasks-path]
Arguments
| Argument | Description |
|---|---|
subtasks-path |
Optional path to subtasks.json file (defaults to subtasks.json in project root) |
What It Shows
Configuration
- Whether
ralph.config.jsonexists in the project
Subtasks Queue
- Current milestone name (from taskRef or milestone field)
- Progress bar with done/total count and percentage
- Last completed subtask with timestamp
- Next pending subtask in queue
Iteration Statistics
- Total iteration count from diary
- Success rate (color-coded: green ≥80%, yellow ≥50%, red <50%)
- Average tool calls per iteration
Examples
Check current build status:
/ralph-status
Check status for a specific subtasks file:
/ralph-status docs/planning/milestones/ralph/subtasks.json
Execution
When invoked, execute the status script:
tools/src/commands/ralph/scripts/status.sh [subtasks-path]
The script handles:
- Missing subtasks file (shows helpful guidance)
- Empty subtask queue (shows empty state message)
- Missing iteration diary (gracefully degrades)
- Both jq and Node.js fallbacks for JSON parsing
CLI Equivalent
This skill provides the same functionality as:
aaa ralph status [subtasks-path]
Related Skills
- ralph-build: Run the build loop to process subtasks
- ralph-calibrate: Run calibration checks on completed work
- ralph-plan: Interactive planning for vision and roadmap
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?