tools-only Insight Extractor Skill
Parse the built-in /insights report and extract actionable items into structured, trackable markdown files.
What it does
Reads ~/.claude/usage-data/report.html (generated by /insights) and extracts:
- Action Items: CLAUDE.md improvements, unfinished tasks, follow-ups
- Useful Prompts & Patterns: Effective interaction strategies and copyable prompts
- Technical Learnings: Debugging insights, friction patterns, what worked
- Workflow Improvements: Better approaches discovered across sessions
- Tool Discoveries: Features to try, new commands, MCP tools
- Automation Candidates: Repetitive tasks that could be automated (tagged #automation-candidate, agent-runnable ones tagged #agent-task)
Usage
Auto mode (default)
/insight-extractor
Extracts all categories, saves everything automatically using configured paths.
Interactive mode
/insight-extractor --interactive
Walks through each category with AskUserQuestion -- cherry-pick items, set priorities, choose which automations get task files.
Configure mode
/insight-extractor --configure
Walk through settings via AskUserQuestion. Configures:
- Insights folder -- where insight files are saved (default:
Research/Insights) - Tasks folder -- where automation task files go (default:
Tasks/inbox, or disable) - Daily notes folder -- where daily notes live (default:
Daily) - MoC file -- which MoC tracks insights (default:
MoC - Insights.md, or disable) - Date format --
YYYYMMDD(compact) orYYYY-MM-DD(ISO) - Machine name -- include in filenames or not
- Statistics -- include session stats section or not
- Stale threshold -- warn if report older than N days
Settings saved to .claude/skills/insight-extractor/config.json.
Without machine name
/insight-extractor --no-machine
Prerequisites
Run /insights first to generate the report. The extractor reads from:
~/.claude/usage-data/report.html(main report)~/.claude/usage-data/facets/(structured JSON data)
Output
Insight file
Research/Insights/YYYYMMDD-insights-{machine}.md with YAML frontmatter and 6 categorized sections.
Daily note link
Appends to today's Daily/YYYYMMDD.md under ## Insights or ## log.
MoC update
Adds entry to MoC - Insights.md under ## Recent Insights.
Task creation
For each automation candidate, creates Tasks/inbox/YYYYMMDD-automate-{slug}.md.
Interactive Mode Details
In --interactive mode, the skill uses AskUserQuestion at each stage:
- Action Items: Include all / review each / skip
- Automation Candidates: Multi-select which ones get task files
- Priority Override: Keep defaults / prioritize CLAUDE.md items / prioritize automation / custom
- Personal Notes: Option to add context before saving
Machine-Specific Behavior
Includes hostname in filename by default (2 machines, different session contexts). MoC groups by date across machines.
When to use
- After running /insights: Extract and persist the analysis into your vault
- Weekly review: Process insights, review MoC for patterns across days/machines
- Automation discovery: Find and track repetitive patterns worth automating
Integration
- ~/.claude/usage-data/report.html: Source data
- MoC - Insights.md: Master index
- Daily notes: Quick reference links
- Tasks/inbox/: Automation candidates become actionable
- MoC - Personal Productivity: Session-as-Memory theme