skill-usage-audit

---

name: skill-usage-audit description: {{AGENT_NAME}} skills/ 디렉토리의 121개 SKILL.md를 3-criteria hard evidence 기준으로 dead/active 분류 — cron 등록, wikilink 참조, mtime 임계치 title: Skill Usage Audit — 3-Criteria Hard Evidence 분류 type: skill space: growth tags: [skill, audit, skills, hygiene, diagnostics, dead-code] created: 2026-06-03 updated: 2026-06-03 links:

• "[[@identity/brain/{{AGENT_NAME}}-brain/P0-brainstem/禁/禁no_linear_workflow]]"
• "[[@identity/brain/{{AGENT_NAME}}-brain/P0-brainstem/禁/禁filesystem_truth.neuron]]"
• "[[skills/filesystem-truth-audit]]"
• "[[skills/cron-jobs-stalled]]"
• "[[skills/kanban-dispatcher-stalled]]"
• "[[@identity/SELF_MODEL]]"
• "[[@identity/persona/SOUL]]"
• "[[@identity/brain/rules]]"---

Skill Usage Audit — 3-Criteria Hard Evidence 분류

~/.{{AGENT_NAME_LOWER}}/skills/ 의 모든 SKILL.md를 dead/active로 분류하는 진단 스킬. filesystem_truth + active workflow 매핑으로 판정. P0-brainstem 강제.

Trigger

다음 중 하나:

• "스킬이 다 사용 중이야?" / "안 쓰는 스킬 있나?" 요청
• 새 skill batch 추가 후 (hugh 박스 import, 외부 repo 흡수)
• 6개월 주기 위생 점검
• context menu / skill picker가 noisy (선택지 너무 많음)
• 정책 위반 의심 (linear 등)

배경: 왜 3-criteria 인가

{{AGENT_NAME}}는 hugh-kim 박스에서 ~100개 skill을 가져왔는데, 그 중 60%는 한 번도 안 쓰는 dead 코드. 단일 기준 (mtime 또는 위키 wikilink만) 으로는 오판 위험:

• mtime만 → "최근에 수정 안 했어도 active일 수 있음" (예: kanban-worker는 5/20 이후 mtime 그대로지만 cron에서 매일 호출)
• wikilink만 → "위키에 언급 안 됐어도 active일 수 있음" (예: YOUR_PREFIX-content-status-enforcement는 6/1에 만들어졌고 6/1부터 매번 YOUR_DOMAIN 빌드 시 사용)
• cron 등록만 → "cron에 안 올라가도 active일 수 있음" (예: filesystem-truth-audit은 skill_view로 수동 호출)

→ 3가지 hard evidence 모두 모자라야 dead로 판정.

Procedure

Step 1: 인벤토리 — SKILL.md 모두 찾기

find ~/.{{AGENT_NAME_LOWER}}/skills -name SKILL.md 2>/dev/null | wc -l
find ~/.{{AGENT_NAME_LOWER}}/skills -name SKILL.md 2>/dev/null | xargs -I{} dirname {} | xargs -I{} basename {} | sort -u

기대치: 100~150개 (HUGH 박스 + {{AGENT_NAME}} 자체).

Step 2: mtime 분류 — 3-tier 임계치 (5/14, 5/20, 6/1)

for d in ~/.{{AGENT_NAME_LOWER}}/skills/*/; do
  name=$(basename "$d")
  mt=$(stat -f "%Sm" -t "%Y-%m-%d %H:%M" "$d/SKILL.md" 2>/dev/null)
  if [ -n "$mt" ]; then echo "$mt | $name"; fi
done | sort -r