---
name: analyze-insights
description: Analyze Claude Code /insight report and generate actionable files
allowed-tools: ["Bash", "Read", "Write"]
context: fork
argument-hint: "[path-to-report.html]"
---

## 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`

2. **Run the analysis**: Execute claude-insights (auto-detects the report, or pass a path):
   ```bash
   npx claude-insights analyze -o ./insights
   npx claude-insights analyze <report-file> -o ./insights
   ```

3. **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

4. **Apply directly** (alternative): Use `--apply` to merge directly into your project:
   ```bash
   npx claude-insights analyze --apply
   ```

5. **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

```bash
# 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
```