autoskill

name	autoskill
description	Manage the AutoSkill system — check status, trigger extraction, search and import history, refine skills, enable/disable

AutoSkill

AutoSkill watches every Claude Code conversation via hooks, archives turns to SQLite, and periodically calls the Claude API to extract reusable SKILL.md files into ~/.claude/skills/.

When to use

Invoke /autoskill when the user wants to:

• See what skills have been auto-generated
• Search past sessions and selectively import them
• Manually trigger skill extraction
• Import all historical sessions at once
• Refine or clean up existing autoskills
• Tune extraction frequency or disable AutoSkill

Commands

Run these from a Bash tool call. All output to stdout.

# Show installed autoskills + archive stats
python3 ~/.claude/autoskill/autoskill.py --status

# Search sessions interactively — filter by keyword, select which to import+extract
python3 ~/.claude/autoskill/autoskill.py --search docker
python3 ~/.claude/autoskill/autoskill.py --search          # no query = show all

# Force extraction for the current session
python3 ~/.claude/autoskill/autoskill.py --extract "$CLAUDE_SESSION_ID"

# Import ALL historical transcripts into the archive
python3 ~/.claude/autoskill/autoskill.py --import

# Extract skills from all imported (unprocessed) sessions
python3 ~/.claude/autoskill/autoskill.py --extract-all

# Refinement pass: improve descriptions, merge near-duplicates
python3 ~/.claude/autoskill/autoskill.py --refine

# Tail the live log
tail -f ~/.claude/autoskill/autoskill.log

Search selection syntax

--search shows a numbered table then prompts for a selection:

Input	Meaning
1 3 5	Sessions 1, 3, and 5
2-4	Sessions 2 through 4
1 3-5 8	Mixed numbers and ranges
all	Every result
Enter	Cancel

Configuration

Edit ~/.claude/autoskill/config.json:

Key	Default	Meaning
enabled	true	Master on/off switch
extract_every_turns	8	Extract after every N archived turns
min_turns_extraction	4	Don't extract if fewer turns than this
max_skills_per_run	3	Max skills generated per extraction
model	claude-sonnet-4-6	Model used for extraction
skill_prefix	as-	Directory prefix for autogenerated skills
log_level	info	debug / info / error

Hook wiring (already installed)

AutoSkill fires on four Claude Code lifecycle events:

Event	Action
UserPromptSubmit	Archives user turn to SQLite
Stop	Archives assistant response; spawns extractor if N turns
SessionEnd	Spawns final extractor for the session
PreCompact	Spawns extractor before context window is compacted

Autogenerated skill naming

Skills are written to ~/.claude/skills/as-<name>/SKILL.md. The description frontmatter field is what Claude Code uses to decide whether to load the skill — AutoSkill writes this field to match the keywords a user would type when needing that skill.