Agent skill · writing content · aiskillstore
improve-skill
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.
Why this skill is useful
Adds a script for extracting session transcripts and generating prompts for skill improvement or creation, which the AI wouldn't reliably generate on its own.
What it needs
Requires node installed locally. About 2k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
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: Session Extraction The extract-session.js script finds and parses session files from any of the three agents: 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: 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 improvement prompt for a new session: Workflow: Create a New Skill When asked to create a new skill from a session: 1. Extract the session transcript: 2. Generate a creation prompt for a new session: Why a Separate Session? The improvement prompt is meant to be copied into a fresh agent session because: 1. Token efficiency - The current session already has a lot of context; starting fresh means only the transcript and skill are loaded 2. Clean analysis - The new session can focus purely on improvement without being influenced by the current task 3. Reproducibility - The prompt is self-contained and can be shared or reused Tips for Good Skill Improvements When analyzing a transcript, look for: Confusion patterns - Where did the agent retry or change approach? Missing examples - What specific commands or code patterns were discovered? Workarounds - What did the agent have to figure out that wasn't documented? Errors - What failed and how was it resolved? Successful patterns - What worked well and should be highlighted? Keep skills concise - focus on the most important information and examples.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/improve-skill