| name | improve-skill |
| description | Analyze coding agent session transcripts to improve existing skills or create new ones. Use when asked to improve a skill based on a session, or extract a new skill from session history. |
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:
./scripts/extract-session.js
Session Extraction
The extract-session.js script finds and parses session files from any of the three agents:
./scripts/extract-session.js
./scripts/extract-session.js --agent claude
./scripts/extract-session.js --agent pi
./scripts/extract-session.js --agent codex
./scripts/extract-session.js --cwd /path/to/project
./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:
-
Extract the session transcript:
./scripts/extract-session.js > /tmp/session-transcript.txt