Optimization sync-skill-catalog

모든 스킬의 메타데이터를 자동 추출하여 skill-catalog.md를 동기화한다.

install

source · Clone the upstream repo

git clone https://github.com/sunLeee/optimization

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/sunLeee/optimization "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/utility/sync-skill-catalog" ~/.claude/skills/sunleee-optimization-sync-skill-catalog && rm -rf "$T"

manifest: .claude/skills/utility/sync-skill-catalog/SKILL.md

source content

sync-skill-catalog

모든 스킬 메타데이터를 자동 추출하여 카탈로그를 동기화하는 스킬.

목적

스킬 추가/수정 시 자동 카탈로그 업데이트
버전 관리 자동화
메타데이터 일관성 유지
글로벌 디렉토리 동기화

사용법

/sync-skill-catalog              # 표준 동기화
/sync-skill-catalog --auto-version # 버전 자동 증분 (v1.16.0 → v1.17.0)

자동 추출 필드

필드	추출 위치	용도
`name`	frontmatter	스킬 이름
`description`	frontmatter	설명 (카탈로그)
`user-invocable`	frontmatter	호출 유형 (Primary/Internal)
`model`	frontmatter	사용 모델
`version`	Changelog	스킬 버전
`category`	스킬명 분석	자동 분류
`skill-type`	context 분석	Atomic/Composite 판정

카테고리 분류 규칙

스킬명 패턴	카테고리
`check-*`	코드 검증
`quality-*`	품질 관리
`convention-*`	컨벤션 참조
`setup-*`	환경 설정
`doc-*`	문서 생성
`manage-*`	문서 관리
`ref-*`	레퍼런스/시나리오

실행 예제

User: /sync-skill-catalog

Claude:
=== 스킬 카탈로그 동기화 ===

📊 스킬 파싱 중...
✅ 파싱 완료: 61개 스킬

📋 카테고리별 분류:
  개발 지원: 4개
  코드 검증: 8개
  ...

📝 카탈로그 생성 중...
✅ Project: /Users/hmc123/Documents/hyundai/.../skill-catalog.md
✅ Global: /Users/hmc123/.claude/docs/skill-catalog.md

===== 동기화 완료 =====
v1.16.0 → v1.17.0
61개 스킬 카탈로그 업데이트

통합 방식

1. 수동 호출

스킬 추가/수정 후

/sync-skill-catalog

실행.

2. manage-skill 통합

스킬 생성 후 자동으로 카탈로그 동기화.

3. Pre-commit Hook

.git/hooks/pre-commit

에서 SKILL.md 변경 감지 시 자동 실행.

Changelog

날짜	버전	변경 내용
2026-01-21	1.0.0	초기 생성 - 스킬 카탈로그 자동 생성

Gotchas (실패 포인트)

skill-catalog.md가 실제 파일과 불일치 시 오래된 정보로 Claude 혼란
새 skill 추가 후 sync 미실행 시 catalog 누락
name: 필드 없는 SKILL.md는 catalog에서 제외됨 — frontmatter 필수
category 분류가 자동화되지 않음 — 수동 검토 필요