distill-skill

Mines past Claude Code session transcripts to draft reusable skills from completed workflows.

Updated Jul 13, 2016
One-click install
npx skills add https://github.com/yang-l/configs --skill distill-skill-yang-l
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: distill-skill
Source: https://github.com/yang-l/configs/tree/main/.claude/skills/distill-skill
Command: npx skills add https://github.com/yang-l/configs --skill distill-skill-yang-l

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Rebuilding a workflow you already performed once means re-explaining everything from scratch. This Skill mines your own past Claude Code session transcripts to recover the exact steps, commands, and dead ends, then drafts a reusable skill without a fresh interview. ## Core Features & Use Cases - Session transcript mining: Lists and filters .jsonl session transcripts under ~/.claude/projects/, including subagent transcripts, using a stdlib-only Python helper script. - Structured extraction with safeguards: Delegates interpretation to a read-only researcher agent that produces what/command/verify/why steps, tags unsafe verification commands, redacts credentials and hostnames, and flags conflicts with feedback memories. - Human-gated authoring: Presents the draft for explicit approval, then hands off to skill-creator for authoring, validation, and gitignore-by-default writing. - Use Case: You fixed a tricky deployment issue last week and want it captured. Ask to turn that past session into a skill, and this Skill locates the transcript, extracts the verified procedure, and drafts it for your review. ## Quick Start Turn the workflow from my session last week where I fixed the deploy pipeline into a reusable skill.

Frequently Asked Questions about distill-skill

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

FAQPage Schema
How do I turn a past Claude Code session into a reusable skill?▼

Reference the past work in plain language, such as naming the session or the task you completed. The Skill lists matching session transcripts, filters the relevant commands and decisions, drafts the procedure, and hands it to skill-creator after your approval.

How does session transcript mining find the right session?▼

The bundled mine_sessions.py script lists sessions by matching a project token against real directory names under ~/.claude/projects/, then builds a dated, titled manifest from ai-title and last-prompt records inside the .jsonl files. It never reads sessions-index.json, which is stale.

Does it write the new skill file directly?▼

No. It only mines, filters, and drafts the procedure, then presents the draft for explicit human approval. The actual authoring and validation are delegated to skill-creator, and the new skill directory is appended to .gitignore by default.

What happens if no matching session or procedure is found?▼

The Skill stops and reports that no clear procedure was found rather than fabricating steps. The helper script exits non-zero with an explicit message on empty results, and the researcher agent flags partial or missing procedures as open questions.

How are credentials and internal hostnames handled when mining sessions?▼

The extraction step redacts account IDs, ARNs, tokens, and internal hostnames to placeholders before drafting. Combined with gitignore-by-default on write, this prevents sensitive content from being committed to a public repository.

When should I use skill-creator instead of distilling from history?▼

Use skill-creator when you want a brand-new skill with no prior session to reference. Distillation only applies when the workflow was already performed in a past session whose transcripts can be mined.