improve-skilllisted

# Improve Skill This skill helps analyze coding agent sessions to improve or create skills. It works with Claude Code, Pi, and Codex session files. ## Quick Start Extract the current session and generate an improvement prompt: ```bash # Auto-detect agent and extract current session ./scripts/extract-session.js ``` ## Session Extraction The `extract-session.js` script finds and parses session files from any of the three agents: ```bash # Auto-detect (uses most recent session for current working directory) ./scripts/extract-session.js # Specify agent type ./scripts/extract-session.js --agent claude ./scripts/extract-session.js --agent pi ./scripts/extract-session.js --agent codex # Specify a different working directory ./scripts/extract-session.js --cwd /path/to/project # Use a specific session file ./scripts/extract-session.js /path/to/session.jsonl ``` **Session file locations:** - **Claude Code**: `~/.claude/projects/<encoded-cwd>/*.jsonl` - **Pi**: `~/.pi/agent/sessions/<encoded-cwd>/*.jsonl` - **Codex**: `~/.codex/sessions/YYYY/MM/DD/*.jsonl` ## Workflow: Improve an Existing Skill When asked to improve a skill based on a session: 1. **Extract the session transcript:** ```bash ./scripts/extract-session.js > /tmp/session-transcript.txt ``` 2. **Find the existing skill** in one of these locations: - `~/.codex/skills/<skill-name>/SKILL.md` - `~/.claude/skills/<skill-name>/SKILL.md` - `~/.pi/agent/skills/<skill-name>/SKILL.md` 3. **Generate an