| name | yt |
| description | YouTube 시청 기록을 수집·분류·요약하는 로컬 리포 스킬. yt-digest 리포에서 npm script로 데이터 파이프라인을 돌리고, 카테고리 분류와 한 줄 요약은 스킬(Claude)이 채널 메타데이터를 읽고 직접 수행한다. |
YouTube Digest
이 스킬은 현재 리포를 작업공간으로 사용한다. Playwriter CLI를 길게 조합하지 말고 항상 npm run 진입점을 우선 사용한다. 카테고리 분류와 요약은 LLM API가 아니라 스킬이 직접 채널 컨텍스트를 읽고 판단한다.
Commands
/yt 또는 /yt all: 전체 파이프라인 (scrape → enrich → channels → classify(스킬) → digest)/yt scrape: npm run yt:scrape — 시청 기록 수집/yt channels: npm run yt:channels — 히스토리에 등장한 채널 메타데이터를 data/channels/에 캐시 (TTL 7일)/yt enrich: npm run yt:enrich로 필드 정규화 후 스킬이 카테고리/요약을 채움/yt digest: npm run yt:digest- 환경 점검:
npm run yt:doctor
Workflow
/yt 전체 파이프라인
- 필요하면
npm install
npm run yt:doctor로 세션/환경 확인. 세션이 없으면 npx playwriter session new 실행을 사용자에게 요청npm run yt:scrape — 최신 data/history/history-YYYY-MM-DD.json 생성npm run yt:enrich — oEmbed로 channelUrl/channelId 채우고, category/summary가 없으면 null로 초기화 (더 이상 키워드 매칭을 하지 않는다)npm run yt:channels — 히스토리의 채널 중 캐시가 없거나 7일 이상 된 것을 Playwriter로 보강, data/channels/<channelId>.json 저장- 스킬이 직접 분류·요약 (아래 "Classification Step" 참조)
npm run yt:digest — 주간 인사이트 생성
Classification Step (스킬이 수행)
data/index.json에서 latestHistory 경로를 확인하고 해당 파일을 읽는다category가 null인 항목을 대상으로, 각 영상의 channelId로 data/channels/<channelId>.json을 읽어 채널 description과 recentVideoTitles를 함께 참고한다references/categorization.md의 판정 가이드를 따라 카테고리 하나를 고르고, 한 줄 요약(summary)을 한국어로 작성한다- 채널 캐시가 없거나 비어 있으면 제목/채널명만으로 최선의 추정을 하고, 확신이 약하면
기타로 둔다
- 같은 history 파일을 그대로 덮어쓴다(다른 필드 건드리지 말 것).
writeJson과 동일한 포맷(2 space indent, trailing newline)을 유지한다
단일 단계 실행
/yt scrape, /yt channels, /yt digest는 각 npm 스크립트만 실행/yt enrich는 npm run yt:enrich 실행 후 Classification Step까지 스킬이 수행
Session Handling
- 기본적으로
PLAYWRITER_SESSION 환경 변수를 우선 사용한다
- 세션이 하나뿐이면 스크립트가 자동 선택을 시도한다
- 세션이 여러 개면
PLAYWRITER_SESSION=<name> npm run yt:scrape 또는 -- --session <name>으로 지정한다
Data Contract
- 일별 기록:
data/history/history-YYYY-MM-DD.json
- 채널 캐시:
data/channels/<channelId>.json (TTL 7일)
- 주간 인사이트:
data/weekly/weekly-YYYY-WNN.json
- 최신 포인터:
data/index.json
세부 필드는 references/data-schema.md, 분류 규칙은 references/categorization.md, 카테고리 목록은 references/categories.md, 운영 흐름은 references/workflow.md를 참고한다.
