history-insight
This skill should be used when user wants to access, capture, or reference Claude Code session history. Trigger when user says "capture session", "save session history", or references past/current conversation as a source - whether for saving, extracting, summarizing, or reviewing. This includes any
By ai-native-camp · 1,309 installs
npx skills add ai-native-camp/camp-2 --skill history-insight
Source repository · Upstream listing
History Insight
Claude Code 세션 히스토리를 분석하고 인사이트를 추출합니다.
Data Location
Path Encoding: /Users/foo/project → Users foo project
상세 파일 포맷: ${baseDir}/references/session file format.md
Execution Algorithm
Step 1: Ask Scope [MANDATORY]
스코프 결정:
1. 명시된 경우 (AskUserQuestion 생략 가능):
"현재 프로젝트만" / "이 프로젝트" → current project
"모든 세션" / "전체" → all sessions
2. 명시되지 않은 경우 AskUserQuestion 호출:
Step 2: Find Session Files
날짜 필터링 : 파일의 mtime(수정시간) 확인 후 필터. OS별 stat 옵션 다름:
macOS: stat f "%Sm" t "%Y %m %d" <file
Linux: stat c "%y" <file
Step 3: Process Sessions
Decision Tree
1 3 Files
직접 Read로 JSONL 파싱. 파일이 크면(≥5000 tokens) extract session.sh 사용:
4+ Files: Batch Extract Pipeline
1. 캐시 디렉토리 생성 ( /tmp/cc cache/<analysis name / )
2. 세션 목록 저장 ( sessions.txt )
3. jq로 메시지 일괄 추출 ( user messages.txt )
4. 정리 및 필터링 ( clean messages.txt )
5. Task(opus)로 종합 분석
파일이 너무 클 때: 병렬 배치 분석
clean messages.txt 가 너무 커서 Read 실패 시:
1. 파일 분할 :
2. 병렬 Task(opus) 호출 :
3. 결과 병합 : Task(opus)로 종합
Step 4: Report Results
Error Handling
Scenario Response
No session files found "No session files found for this project."
File too large Auto preprocess with extract session.sh
jq not installed "Error: jq is required. Install with: brew install jq"
Task failed "Warning: Could not process [file]. Skipping."
0 relevant sessions "No sessions matched your criteria."
Security Notes
출력에 전체 경로 노출 금지 ( ~ prefix 사용)
Related Resources
${baseDir}/scripts/extract session.sh JSONL 압축 (thinking, tool use 제거)
${baseDir}/references/session file format.md JSONL 구조 및 파싱