사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/yahav10/claude-insights --skill analyze-insights시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
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
