From skill-semver
Guides Semantic Versioning for Claude Code Skills with folder structures, CHANGELOG formats, auto-backups via PostToolUse Hook, manual release procedures, and migration scripts. Useful for maintaining skill histories.
npx claudepluginhub cathy-kim/skill-semver --plugin skill-semverThis skill uses the workspace's default tool permissions.
> 스킬 버전 관리를 위한 가이드 및 자동화 지원
Improves existing pm-skills using feedback, validation reports, or convention changes. Reads files, previews grouped changes, applies on confirmation, suggests version bump.
Publishes Claude Code plugins by bumping versions in plugin.json, updating CHANGELOG.md, validating structure, and pushing to GitHub; supports standalone Agent Skills.
Evolves existing skills by refining content in-place or creating advanced variants. Assesses gaps, applies changes, updates version metadata, syncs registry/cross-references. Use for outdated steps, feedback gaps, complexity upgrades.
Share bugs, ideas, or general feedback.
스킬 버전 관리를 위한 가이드 및 자동화 지원
Version: 1.0.0 Last Updated: 2026-01-30
이 스킬은 Claude Code Skills의 버전 관리 방법을 안내하고 자동화를 지원합니다.
MAJOR.MINOR.PATCH
예: 3.1.0
- MAJOR: 호환성 깨지는 대규모 변경 (Breaking Changes)
- MINOR: 새로운 기능 추가 (Features)
- PATCH: 버그 수정, 문서 개선 (Fixes)
| 변경 유형 | 버전 증가 | 예시 |
|---|---|---|
| 핵심 로직 변경 | MAJOR | Workflow 구조 변경 |
| Phase 추가/제거 | MAJOR | Phase 4.5 추가 |
| 새 기능 추가 | MINOR | Context Injection 도입 |
| Agent/Hook 추가 | MINOR | 새 Agent 정의 추가 |
| 버그 수정 | PATCH | 오타 수정, 설명 보완 |
| 문서 개선 | PATCH | 예시 추가, 가독성 개선 |
각 Skill은 다음 구조를 따릅니다:
.claude/skills/[skill-name]/
├── SKILL.md # 현재 버전 (최신)
├── CHANGELOG.md # 변경 히스토리
├── releases/ # 버전별 스냅샷
│ ├── v1.0.0_2025-12-01_SKILL.md
│ ├── v2.0.0_2025-12-15_SKILL.md
│ └── v3.1.0_2026-01-21_SKILL.md
├── references/ # 참조 문서 (선택)
├── agents/ # Agent 정의 (선택)
└── templates/ # 템플릿 (선택)
SKILL.md 상단에 다음 형식 필수:
# [Skill Name]
> [Skill 설명]
**Version**: 3.2.0
**Last Updated**: 2026-01-22
# Changelog - [Skill Name]
All notable changes to this skill will be documented in this file.
## [3.1.0] - 2026-01-21
### Added
- Context Injection System 추가
### Changed
- Quality Score 배점 조정
### Fixed
- Goal Retention 문제 해결
이 플러그인은 SKILL.md 파일 수정 시 자동으로 백업을 생성합니다:
releases/v{VERSION}_{DATE}_SKILL.md 백업 생성# 1. SKILL.md 상단 버전 업데이트
# **Version**: 3.2.0
# 2. CHANGELOG.md에 변경 사항 기록
## [3.2.0] - 2026-01-22
### Added
- 새 기능 설명
# 3. Git 커밋
git add SKILL.md CHANGELOG.md releases/
git commit -m "feat([skill-name]): Release v3.2.0 - 새 기능 설명"
기존 Skills에 버전 관리를 적용하려면:
npx tsx scripts/migrate-skill-versioning.ts
이 스크립트는: