스킬 거버넌스 (skill-governance)

무엇을 해주나

로컬 소스 저장소를 "단일 진실 공급원(SSOT)"으로 두고, Claude Code의 플러그인/스킬 캐시가 소스와 어긋났는지 점검하고 정리합니다.

• 워크플로 A — 드리프트 점검(읽기 전용): 마켓플레이스별로 소스와 ~/.claude/plugins/cache/를 비교해 Stale(내용 불일치), 버전 불일치, 캐시 누락, 고아 플러그인, ~/.claude/skills/ 직접 복사 드리프트를 표로 보고합니다.
• 워크플로 B — 소스 기준 동기화: claude plugin marketplace update → uninstall → install을 원래 설치 스코프(user/project)로 재실행해 캐시를 다시 받아옵니다. 파일 수동 복사는 금지.
• 워크플로 C — 오래된 캐시 버전 정리: semver 하위 디렉터리 중 최신만 남기고, 최신본이 소스와 일치하는지 먼저 검증합니다.
• 워크플로 D — 마켓플레이스를 로컬 소스로 전환: 잘못된 원본을 가리키고 있을 때 remove/add로 교체.
• 워크플로 E — 떠도는 user 스킬 감사: ~/.claude/skills, ~/.codex/skills, ~/.agents/skills의 스킬을 lock 관리 / 소스 복사본 / 얄팍한 템플릿 / 가치 있는 스킬 / 폐기 백업으로 분류하고, 지우는 대신 retired-skills/<이유>-<날짜>/로 이동합니다.

.git, node_modules, __pycache__, *-workspace, dist 같은 비교 제외 목록과 스위트(suite) 플러그인 처리 규칙, 문제 해결 가이드, 표준 보고서 템플릿까지 포함되어 있습니다.

이런 분께 추천

• Claude Code 스킬/플러그인을 직접 만들어 마켓플레이스로 배포하는 개발자
• 스킬을 여러 개 설치해 캐시가 오래되고 중복 버전이 쌓인 사용자
• ~/.claude/skills에 출처를 알 수 없는 스킬이 잔뜩 쌓여 정리하고 싶은 분
• 팀 내 스킬 배포 규칙(공식 명령어만 사용, 스코프 보존)을 지키게 만들고 싶은 운영자

활용 예시

1. "skill 드리프트 점검해줘" → 마켓플레이스별로 Stale 3건, 버전 불일치 1건, 고아 플러그인 2건을 표로 정리한 보고서를 받습니다. 이 단계는 아무것도 바꾸지 않습니다.
2. "소스 기준으로 스킬 캐시 동기화해줘" → 마켓플레이스가 로컬 경로를 가리키는지 확인한 뒤, 어긋난 플러그인만 원래 스코프로 재설치하고 마지막에 구버전 캐시를 정리합니다.
3. "~/.claude/skills 안에 있는 얄팍한 스킬 정리해줘" → 줄 수와 스크립트/참조 파일 유무로 분류해, 대체 가능한 템플릿만 retired-skills/로 백업 이동하고 가치 있는 스킬은 남깁니다.

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 daymade/claude-code-skills 의 daymade-skill/skill-governance 폴더를 내 ~/.claude/skills/skill-governance/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.