analyze-insights

When to Use This Skill

• When you have a Claude Code /insight report HTML file to analyze
• After running /insight in Claude Code and saving the HTML report
• When you want to generate skills, CLAUDE.md rules, hooks, and todos from your usage patterns

Steps

1. Locate the report: Find the /insight HTML report file. Common locations:

• ~/.claude/usage-data/report.html
• A saved file from the browser after running /insight

1. Run the analysis: Execute claude-insights (auto-detects the report, or pass a path):

   npx claude-insights analyze -o ./insights
   npx claude-insights analyze <report-file> -o ./insights

1. Review the output: Check the generated files in the output directory:

• insights-todo.md — Prioritized task list
• CLAUDE.md-additions.md — Rules to add to your CLAUDE.md
• .claude/settings-insights.json — Hook configurations
• .claude/skills/*/SKILL.md — Generated skills
• insights-README.md — Placement guide

1. Apply directly (alternative): Use --apply to merge directly into your project:

   npx claude-insights analyze --apply

1. Verify: Check that the generated rules and skills make sense for your project.

Rules

• Always review generated output before applying to your project
• The --apply mode deduplicates rules — safe to run multiple times
• Generated skills are based on YOUR friction patterns and are project-specific

Examples

# Auto-detect report and apply (simplest)
npx claude-insights analyze --apply

# Wait for report to appear, then apply
npx claude-insights analyze --wait --apply

# Standard analysis with explicit file
npx claude-insights analyze ~/report.html -o ./my-project

# With facet data enrichment
npx claude-insights analyze --apply --facets

# Watch for report changes
npx claude-insights watch ~/report.html -o ./my-project

# Team aggregation
npx claude-insights team report1.html report2.html -o ./team-output