원문: anandsaini18/deadskills · 커밋 d35b9f9(2026-07-14) · Stars 약 40 · README 기준 MIT(보고서 스키마는 CC0) · npm deadskills

개요

설치된 스킬은 쓰든 안 쓰든 이름과 description이 모든 프롬프트에 들어간다. deadskills는 이 상시 비용을 “컨텍스트 세금(context tax)“이라 부르고, 로컬 세션 기록을 읽어 어떤 스킬이 값을 하고 어떤 스킬은 지워도 되는지 보여 준다. ~/.claude, ~/.codex를 자동 감지하며 설정·로그인·텔레메트리가 없다.

npx deadskills              # 전체 보고서
npx deadskills dead         # dead 스킬만
npx deadskills doctor       # 트랜스크립트 파싱 상태 점검
npx deadskills --since 30d --json

보고서가 알려 주는 것

  1. 설치된 스킬 전체가 매 프롬프트에 더하는 토큰 수
  2. 스킬별 실제 호출 횟수와 추정 토큰 합계 (주입 비용 × 턴 수 + 확장 비용 × 호출 수)
  3. 지울 후보와 그 프롬프트당 비용
  4. 몇 개 세션·턴을 읽었는지
상태의미
active한 번 이상 호출됨
zombie예전엔 썼지만 90일 이상 조용함
dead설치 후 한 번도 호출 안 됨

설계 메모

  • 스킬 디렉터리의 SKILL.md frontmatter에서 이름·설명·토큰 비용을 읽고, 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 둘뿐이다.