---
name: Ralph Analytics
slug: ralph-analytics
category: AI Engineering
description: Ralph Analytics shows aggregate metrics from agent loop execution history. It is used to review success rates, iteration counts, stuck loops, reflections, and escalation patterns.
github: "https://github.com/jmagly/aiwg/tree/main/agentic/code/addons/agent-loop/skills/ralph-analytics"
language: TypeScript
stars: 209
forks: 32
install: "npx degit https://github.com/jmagly/aiwg/tree/main/agentic/code/addons/agent-loop/skills/ralph-analytics ~/.claude/skills/ralph-analytics"
installs_to: ~/.claude/skills/ralph-analytics
source_path: agentic/code/addons/agent-loop/skills/ralph-analytics/SKILL.md
collection_size: 25
category_size: 2970
collection_url: "https://dirskills.com/collections/jmagly/aiwg"
added: 2026-09-04T05:26:59.989Z
last_synced: 2026-09-04T05:26:59.989Z
canonical_url: "https://dirskills.com/skills/ralph-analytics"
---

# Ralph Analytics

Ralph Analytics shows aggregate metrics from agent loop execution history. It is used to review success rates, iteration counts, stuck loops, reflections, and escalation patterns.

**Install:**

```bash
npx degit https://github.com/jmagly/aiwg/tree/main/agentic/code/addons/agent-loop/skills/ralph-analytics ~/.claude/skills/ralph-analytics
```

## README

# Al Analytics Command

Display aggregate analytics and metrics from agent loop execution history.

## Instructions

When invoked, analyze agent loop data and present metrics:

1. **Scan Loop History**
   - Load all loop records from `.aiwg/ralph/`
   - Load reflections from `.aiwg/ralph/reflections/`
   - Load debug memory from `.aiwg/ralph/debug-memory/`

2. **Calculate Metrics**
   - **Success rate**: % of loops that completed successfully
   - **Average iterations**: Mean iterations to completion
   - **Reflection reuse rate**: % of reflections applied in subsequent loops
   - **Stuck loop rate**: % of loops that hit stuck detection
   - **Escalation rate**: % requiring human intervention

3. **Pattern Analysis**
   - Most common failure types
   - Most effective fix patterns
   - Average time per iteration
   - Quality trajectory per loop

4. **Display Dashboard**
   - Summary metrics table
   - Trend indicators (improving/stable/degrading)
   - Recommendations for improvement

## Arguments

- `--since [date]` - Analyze loops from date (default: all)
- `--loop [id]` - Analyze specific loop
- `--export [path]` - Export analytics to file
- `--brief` - Show summary only

## References

- @$AIWG_ROOT/agentic/code/addons/ralph/schemas/reflection-memory.json - Reflection schema
- @$AIWG_ROOT/agentic/code/addons/ralph/schemas/debug-memory.yaml - Debug memory schema
- @$AIWG_ROOT/agentic/code/addons/ralph/docs/reflection-memory-guide.md - Guide