skills.rest
Graffioh
GraffiohCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

improve-skill

Analyze coding agent session transcripts to generate SKILL.md improvements.

Updated Jan 29, 2026
Search Tags:#workflow#coding#analyze#prompt-generation#skill-improvement#session-transcripts
One-click install
npx skills add https://github.com/Graffioh/dotfiles --skill improve-skill-graffioh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-skill
Source: https://github.com/Graffioh/dotfiles/tree/main/pi/agent/skills/improve-skill
Command: npx skills add https://github.com/Graffioh/dotfiles --skill improve-skill-graffioh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill analyzes coding agent session transcripts to improve existing skills or create new ones. It enables teams to learn from real sessions across Claude Code, Pi, and Codex and iteratively evolve capabilities.

Core Features & Use Cases

  • Analyze transcripts to identify gaps, ambiguities, and missing guidance in existing skills.
  • Generate improvement prompts or new SKILL.md files from session history.
  • Unified cross-agent insights to evolve skills consistently across agent types.

Use Case: When a skill misbehaves in a session, run the extractor to obtain the transcript and generate an improved SKILL.md that addresses the gaps.

Quick Start

Use the improve-skill tool to analyze your latest session and produce an updated SKILL.md.

  1. Run: ./scripts/extract-session.js
  2. Locate the target skill at ~/.codex/skills/<skill-name>/SKILL.md or the equivalent for your agent store.
  3. Apply the prompted updates to refresh the skill or create a new one.

Frequently Asked Questions about improve-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze session transcripts to improve coding agent skills?▼

Analyzing session transcripts to improve coding agent skills involves running the extract-session.js script to extract history and generate concrete SKILL.md updates that address gaps or missing guidance. The tool processes transcripts to produce actionable improvements for existing skill files.

Can I use session history to generate new SKILL.md files?▼

You can use session history to generate new SKILL.md files by analyzing coding agent session transcripts to identify missing guidance. The tool produces new skill definitions adhering to the required frontmatter format for deterministic prompt construction.

Does the transcript extractor work with Claude Code, Pi, and Codex workflows?▼

The transcript extractor works across Claude Code, Pi, and Codex workflows. It applies a unified extraction process to gather session history and evolve skills consistently across different coding agent types.

What is the best way to fix a misbehaving coding skill from a previous session?▼

To fix a misbehaving coding skill, run the session extractor to obtain the transcript and generate an improved SKILL.md. This process analyzes the session history to identify ambiguities and applies prompted updates to refresh the skill.

How do I locate a target skill file for updates after extracting a session transcript?▼

Locate a target skill file for updates by finding the target skill at ~/.codex/skills/<skill-name>/SKILL.md or the equivalent directory for your specific agent store. Apply the prompted updates to refresh the skill at that location.

Related Skills

Explore More Software Engineering Skills→
ale-alfaroale-alfaro

Skill Creator

Scaffold Codex skills by generating SKILL.md templates and starter resource directories.

Community
Advanced
feed-mobfeed-mob
1

gemini-image-generator

Convert prompts and images into Gemini image generation API calls.

Official
Intermediate
ylxmf2005ylxmf2005
11

replay

Extract structured digests from Claude Code and Codex session transcripts.

Community
Advanced
deonneondeonneon
3

prompt-consultant

Parse Claude Code JSONL transcripts to extract and critique user prompts.

Community
Advanced