Self Improve

Overview

Use this Codex-specific skill to inspect prior Codex threads and generate evidence-backed improvement proposals for three targets: skills, project-local AGENTS.md, and global ~/.codex/AGENTS.md.

This skill depends on Codex's local session system (~/.codex/state_5.sqlite plus rollout JSONL files under ~/.codex/sessions and ~/.codex/archived_sessions). It is not intended to work unchanged in non-Codex agent runtimes.

Workflow

When the user invokes $self-improve without a narrower request, run the dream pass automatically; do not ask them to choose a mode. Treat its output, including --emit-patch, as a proposal preview only: validate cited evidence, report the proposals—or that none are strong—and do not edit any file without explicit user approval.

1. Run the session browser to identify candidate threads:

   python3 scripts/self_improve.py list --limit 25 --archived all
   

2. Render specific sessions as readable transcripts when you need direct evidence: