skill-tracker은(는) 무엇을 하나요?
Claude Code 스킬 사용량 모니터링 도구입니다. AI가 어떤 스킬을 사용하는지, 얼마나 자주 사용하는지, 그리고 어떤 프로젝트에서 사용하는지 추적합니다.
개요
이 스킬은 Claude Code 세션에서 사용되는 다른 스킬들의 호출을 자동으로 기록합니다. 각 호출에 대해 스킬 이름, 타임스탬프, 프로젝트 식별자, 선택적 메타데이터를 캡처합니다.
설치
- 저장소를 복제하거나
~/.claude/skills/디렉토리에 스킬을 복사합니다. - Claude Code가 시작될 때 스킬이 자동으로 로드되는지 확인합니다.
사용법
스킬이 활성화되면 다음 명령어를 사용할 수 있습니다:
tracker status— 현재 추적 상태와 지금까지 기록된 이벤트 수를 표시합니다.tracker report— 사용 보고서를 생성합니다. 기본적으로 최근 7일간의 데이터를 보여줍니다.tracker report --days 30— 최근 30일간의 보고서를 생성합니다.tracker report --format csv— 보고서를 CSV 형식으로 내보냅니다.tracker report --format json— 보고서를 JSON 형식으로 내보냅니다.tracker reset— 모든 추적 데이터를 초기화합니다.
구성
추적 동작은 선택적 구성 파일(~/.claude/skill-tracker.json)을 통해 사용자 정의할 수 있습니다:
{
"storage": {
"type": "file",
"path": "~/.claude/skill-tracker-data.json"
},
"tracking": {
"enabled": true,
"excludedSkills": ["built-in", "skill-tracker"]
},
"reporting": {
"defaultDays": 7,
"timezone": "UTC"
}
}
데이터 수집
다음 정보가 각 스킬 호출에 대해 기록됩니다:
- 스킬 이름 — 호출된 스킬의 식별자
- 타임스탬프 — 호출이 발생한 날짜와 시간
- 프로젝트 — Claude Code가 실행 중인 현재 작업 디렉토리 이름
- 인수 — 스킬에 전달된 인수(비활성화 가능)
- 기간 — 스킬 실행 시간(밀리초)
개인 정보 보호
기본적으로 스킬은 민감한 정보를 제외한 메타데이터만 기록합니다. tracker configure --no-args를 사용하여 인수 기록을 비활성화할 수 있습니다.
문제 해결
스킬이 추적되지 않음: 추적이 활성화되어 있는지 tracker status로 확인합니다. ~/.claude/skills/ 디렉토리에 다른 스킬들이 올바르게 설치되어 있는지 확인합니다.
데이터가 너무 큼: tracker reset으로 데이터를 초기화하거나 tracker clean --older-than 30으로 오래된 항목을 정리합니다.