Best use case
ralph-reflect is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
It is a strong fit for teams already working in Codex.
View and manage agent loop reflections and episodic memory
Teams using ralph-reflect should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/ralph-reflect/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How ralph-reflect Compares
| Feature / Agent | ralph-reflect | Standard Approach |
|---|---|---|
| Platform Support | Codex | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
View and manage agent loop reflections and episodic memory
Which AI agents support this skill?
This skill is designed for Codex.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
Cursor vs Codex for AI Workflows
Compare Cursor and Codex for AI coding workflows, repository assistance, debugging, refactoring, and reusable developer skills.
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
AI Agents for Marketing
Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.
SKILL.md Source
# Al Reflect Command View, search, and manage reflections from agent loop iterations. ## Instructions Manage the Reflexion episodic memory stored in `.aiwg/ralph/reflections/`: ### Subcommand: show Display reflections for a specific loop or the most recent loop. 1. Load reflections from `.aiwg/ralph/reflections/loops/` 2. Display each reflection with: - Trial number, timestamp - Outcome (success/failure/partial) - Reflection text - Strategy change ### Subcommand: patterns Show recurring patterns across all loops. 1. Load `.aiwg/ralph/reflections/patterns/` 2. Display patterns by frequency 3. Show success rate for each pattern 4. Highlight patterns applicable to current context ### Subcommand: clear Archive and clear reflection history. 1. Archive current reflections to timestamped directory 2. Reset loops and patterns directories 3. Preserve index.yaml ## Arguments - `show [loop-id]` - Show reflections for loop (default: latest) - `patterns` - Show learned patterns - `clear` - Archive and clear reflections - `--format [yaml|markdown|summary]` - Output format (default: markdown) - `--last [n]` - Show only last n reflections - `--loop [id]` - Filter by loop ID ## References - @$AIWG_ROOT/agentic/code/addons/ralph/schemas/reflection-memory.json - Reflection schema - @$AIWG_ROOT/agentic/code/addons/ralph/docs/reflection-memory-guide.md - Guide - @.aiwg/research/findings/REF-021-reflexion.md - Research foundation
Related Skills
reflection-injection
Inject relevant past reflections into agent context at iteration start so agents learn from prior mistakes without repeating them
ralph-status
Check status of current or previous agent loop
ralph-resume
Resume an interrupted agent loop from last checkpoint
ralph-memory
Manage Al semantic memory entries — list, query, and clear lessons learned across loop iterations
ralph-external
Crash-resilient external loop with state persistence and CI/CD integration
ralph-config
View and configure agent loop settings — show, set, reset, and apply named presets
ralph-attach
Attach to a running agent loop's live output stream
ralph-analytics
Show analytics and metrics from agent loop execution history
ralph-abort
Abort a running agent loop and optionally revert changes
aiwg-orchestrate
Route structured artifact work to AIWG workflows via MCP with zero parent context cost
venv-manager
Create, manage, and validate Python virtual environments. Use for project isolation and dependency management.
pytest-runner
Execute Python tests with pytest, supporting fixtures, markers, coverage, and parallel execution. Use for Python test automation.