How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/yahav10/claude-insights --skill analyze-insightsBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
When to Use This Skill
- When you have a Claude Code /insight report HTML file to analyze
- After running
/insightin Claude Code and saving the HTML report - When you want to generate skills, CLAUDE.md rules, hooks, and todos from your usage patterns
Steps
- 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
- 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- Review the output: Check the generated files in the output directory:
insights-todo.md— Prioritized task listCLAUDE.md-additions.md— Rules to add to your CLAUDE.md.claude/settings-insights.json— Hook configurations.claude/skills/*/SKILL.md— Generated skillsinsights-README.md— Placement guide
- Apply directly (alternative): Use
--applyto merge directly into your project:
bash
npx claude-insights analyze --apply- Verify: Check that the generated rules and skills make sense for your project.
Rules
- Always review generated output before applying to your project
- The
--applymode 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
