원문: anandsaini18/deadskills · 커밋
d35b9f9(2026-07-14) · Stars 약 40 · README 기준 MIT(보고서 스키마는 CC0) · npmdeadskills
개요
설치된 스킬은 쓰든 안 쓰든 이름과 description이 모든 프롬프트에 들어간다. deadskills는 이 상시 비용을 “컨텍스트 세금(context tax)“이라 부르고, 로컬 세션 기록을 읽어 어떤 스킬이 값을 하고 어떤 스킬은 지워도 되는지 보여 준다. ~/.claude, ~/.codex를 자동 감지하며 설정·로그인·텔레메트리가 없다.
npx deadskills # 전체 보고서
npx deadskills dead # dead 스킬만
npx deadskills doctor # 트랜스크립트 파싱 상태 점검
npx deadskills --since 30d --json보고서가 알려 주는 것
- 설치된 스킬 전체가 매 프롬프트에 더하는 토큰 수
- 스킬별 실제 호출 횟수와 추정 토큰 합계 (주입 비용 × 턴 수 + 확장 비용 × 호출 수)
- 지울 후보와 그 프롬프트당 비용
- 몇 개 세션·턴을 읽었는지
| 상태 | 의미 |
|---|---|
| active | 한 번 이상 호출됨 |
| zombie | 예전엔 썼지만 90일 이상 조용함 |
| dead | 설치 후 한 번도 호출 안 됨 |
설계 메모
- 스킬 디렉터리의
SKILL.mdfrontmatter에서 이름·설명·토큰 비용을 읽고, JSONL 트랜스크립트를 파싱한다. 건너뛴 줄은 버리지 않고doctor에 집계한다. - 토큰은 약 4글자/토큰 추정이고, 실제 비용은 프롬프트 캐싱 때문에 대개 더 낮다고 스스로 밝힌다. 그래서 모든 수치에
~를 붙인다. - 런타임 의존성 0, 배포 패키지는 약 22KB 파일 하나, 실행 중 네트워크 호출 없음.
- 에이전트 어댑터는 TypeScript 파일 하나(메서드 3개) + 픽스처로 추가한다.
위키 맥락
스킬·MCP 설명이 컨텍스트를 잠식한다는 문제는 2026-05-01-anthropic-mcp-skills-context-token에서, 안 쓰는 스킬을 정리하는 자동화는 Hermes의 2026-05-02-hermes-curator-garbage-collection-skills에서 다뤘다. deadskills는 이를 Claude Code·codex 사용자가 실사용 데이터로 판단하게 해 주는 측정 도구다. 조직 단위 스킬 관리 관점은 2026-08-30-imad-touil-ai-native-skills-governance 참고.
한계
생성 직후의 초기 프로젝트이고 별도 실행 검증은 하지 않았다. 지원 에이전트는 Claude Code·Codex 둘뿐이다.