skill-metricslisted

# skill-metrics Claude Code가 남긴 세션 JSONL(`~/.claude/projects/**/*.jsonl`)을 집계해 스킬/워크플로우 사용을 **정량 지표**로 환산한다. 목적은 두 가지다: 1. **자동화 우선순위 산정** — 무엇을 먼저 스킬·체인·훅으로 자동화하면 임팩트가 큰가. 2. **상시 측정** — 도달률·빈도 추이로 스킬 채택/이탈을 추적한다. > 측정은 전부 번들된 `scripts/measure.py`가 수행한다. Claude가 JSONL을 직접 > 읽어 토큰을 태우지 않는다 — 스크립트를 호출하고 결과 마크다운만 해석한다. ## 지원 범위 확인 — 먼저 실행 이 스킬의 지표는 **Claude Code 세션 로그가 스킬 호출을 `Skill` 도구 사용으로 기록한다는 사실**에 의존한다. 현재 하네스가 이 관측량을 제공하는지 먼저 확인한다. - Claude Code의 `~/.claude/projects/**/*.jsonl`처럼 `Skill` 도구 호출이 구조화되어 있으면 아래 절차를 계속한다. - 스킬이 프롬프트로 로드될 뿐 별도 도구 호출로 기록되지 않으면 호출 횟수·도달률·전환을 계산할 수 없다. 이 경우 다른 세션 로그를 억지로 비슷하게 파싱하지 말고, "현재 하네스는 스킬 호출을 독립 이벤트로 기록하지 않아 skill-metrics를 지원할 수 없습니다"라고 알린 뒤 종료한다. 파일 위치 차이가 아니라 **지표 정의에 필요한 사건이 없다는 문제**이므로, 추정값을 만들지 않는다. --- ## 실행 절차 ### Step 1: 측정 스크립트 실행 현재 `SKILL.md`가 들어 있는 디렉터리의 `scripts/measure.py`를 실행한다. 호출과 함께 전달된 자연어 인자로 기간을 받는다. ```bash # 기본: 최근 14일, stdout 출력 python3 "<스킬 디렉터리>/scripts/measure.py" --days 14 # 특정 시작일부터 python3 "<스킬 디렉터리>/scripts/measure.py" --since 2026-06-05 --until 2026-06-19 # 프로젝트 필터 + 파일 저장 python3 "<스킬 디렉터리>/scripts/measure.py" --days 14 --project myproject --out /tmp/skill-metrics.md ``` 주요 옵션: | 옵션 | 의미 | 기본 | |---|---|---| | `--days N` | 오늘 기준 최근 N일 | 14 | | `--since YYYY-MM-DD` | 시작일 (지정 시 `--days` 무시) | — | | `--until YYYY-MM-DD` | 종료일 | 오늘 | | `--project <부분문자열>` | 프로젝트 경로 필터 (예: `myproject`) | 전체 | | `--top N` | 랭킹 표 상위 N개 | 15 | | `--out <경로>` | 마크다운 저장 (미지정 시 stdout) | — | 전달된 인자가 숫자면 `--days`로