القائمة
yowu-claude-marketplace 마켓플레이스 및 하위 플러그인의 버전을 올린다. 플러그인 배포, 릴리즈, 버전 태깅, 버전 변경이 필요할 때 사용한다. 마지막 버전 커밋 이후 실제로 변경된 플러그인만 자동 감지하여 업그레이드한다.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | version-upgrade |
| description | yowu-claude-marketplace 마켓플레이스 및 하위 플러그인의 버전을 올린다. 플러그인 배포, 릴리즈, 버전 태깅, 버전 변경이 필요할 때 사용한다. 마지막 버전 커밋 이후 실제로 변경된 플러그인만 자동 감지하여 업그레이드한다. |
마지막 버전 커밋 이후 변경된 플러그인을 자동 감지하고, 해당 플러그인의 버전만 올린다.
.claude-plugin/marketplace.json
└─ metadata.version ← 마켓플레이스 자체 버전 (하나 이상의 플러그인이 업그레이드될 때 범프)
└─ plugins[].version ← 각 플러그인 항목 버전 (plugin.json과 항상 동기화)
plugins/{name}/.claude-plugin/plugin.json
└─ version ← 플러그인 버전 (단일 출처)
대상 플러그인 (명시 없으면 auto — 변경된 플러그인 자동 감지)
auto — git 변경 이력 기반 자동 감지 (기본값)all — 모든 플러그인 강제 업그레이드버전 범프 타입 (명시 없으면 patch)
patch — 1.0.0 → 1.0.1minor — 1.0.0 → 1.1.0major — 1.0.0 → 2.0.0.claude-plugin/marketplace.json의 plugins 배열에서 등록된 플러그인 목록을 읽는다.
플러그인이 0개이면 "등록된 플러그인이 없습니다"로 종료.
각 플러그인의 plugin.json이 마지막으로 변경된 커밋 해시를 구한다:
git log -1 --format="%H" -- plugins/{name}/.claude-plugin/plugin.json
결과가 없으면 (신규 플러그인) → 변경 있음으로 간주.
각 플러그인 디렉토리에서 마지막 버전 커밋 이후 변경된 파일이 있는지 확인:
# {LAST_VERSION_HASH} = Step 2에서 구한 커밋 해시
git diff --name-only {LAST_VERSION_HASH}..HEAD -- plugins/{name}/
출력이 비어 있으면 → 변경 없음 → 버전 업그레이드 대상 제외.
예외: 마지막 버전 커밋이 곧 plugin.json 자체만 변경한 버전 커밋이라면, 그 이후 다른 파일 변경이 없는 것이므로 정상적으로 "변경 없음"으로 처리.
업그레이드 대상으로 선택된 플러그인의 현재 버전을 읽는다:
.claude-plugin/marketplace.json → metadata.version, plugins[].versionplugins/{name}/.claude-plugin/plugin.json → versionSemVer 규칙 적용 (patch 기본):
\d+\.\d+\.\d+)버전 업그레이드 예고 [auto 감지 / patch]
────────────────────────────────────────────────────────
대상 현재 → 새 버전 변경 여부
────────────────────────────────────────────────────────
marketplace 0.1.0 → 0.1.1 (플러그인 업그레이드에 따라)
{plugin-name} 1.0.0 → 1.0.1 ✓ 변경됨 (3 files)
────────────────────────────────────────────────────────
변경 파일:
.claude-plugin/marketplace.json
plugins/{name}/.claude-plugin/plugin.json
진행할까요? (y/n)
업그레이드 대상이 없으면 "모든 플러그인이 최신 버전입니다"로 종료.
사용자 확인 후 적용:
업그레이드 대상 플러그인마다:
plugins/{name}/.claude-plugin/plugin.json → version 업데이트.claude-plugin/marketplace.json → 해당 plugins 항목의 version 업데이트하나 이상의 플러그인이 업그레이드된 경우 추가로:
3. .claude-plugin/marketplace.json → metadata.version 업데이트 (같은 범프 타입 적용)
JSON 수정 시 기존 들여쓰기(4 spaces)와 포맷 유지.
업그레이드 대상 플러그인의 문서를 새 스펙에 맞게 갱신한다.
a) 버전 참조 교체
각 플러그인 README.md에 이전 버전이 하드코딩된 경우 새 버전으로 교체:
# 버전 참조 탐색 (예: "v1.0.0", "@1.0.0" 형태)
grep -rn "OLD_VERSION" plugins/{name}/ --include="*.md"
누락 없이 교체됐는지 재검색으로 확인.
b) 스펙 동기화
플러그인의 README.md가 실제 코드와 일치하는지 검토한다:
plugins/{name}/skills/ — 실제 스킬명 목록 확인plugins/{name}/commands/ — 실제 커맨드 목록 확인plugins/{name}/agents/ — 실제 에이전트 목록 확인plugins/{name}/.claude-plugin/plugin.json — name, description, mcpServers 등 메타데이터 확인루트 README.md (./README.md)는 플러그인 목록, 설치 방법, 구조 설명이 변경된 경우에만 업데이트한다.
업데이트된 문서 파일은 Step 8의 git add에 포함한다.
git add .claude-plugin/marketplace.json \
plugins/{변경된 플러그인들}/.claude-plugin/plugin.json \
plugins/{변경된 플러그인들}/README.md \
README.md # 루트 문서 변경 시에만
git commit -m "chore(version): ..."
커밋 메시지 형식:
chore(version): {plugin-name} 1.0.0 → 1.0.1chore(version): marketplace 0.1.0 → 0.1.1 ({name1}, {name2})chore(version): marketplace 0.1.0 → 0.1.1 (all plugins)push는 하지 않는다 — 사용자가 직접 진행.
# 자동 감지 (기본)
/version-upgrade → auto, patch
"버전 올려줘" → auto, patch
"릴리즈해줘" → auto, patch
# 범프 타입 지정
"minor로 올려줘" → auto, minor
# 강제 지정
"foo 플러그인만 올려줘" → foo, patch
"전체 다 1.1.0으로 올려줘" → all, 1.1.0
plugin.json 파일 자체의 변경(버전 숫자만 바뀐 것)은 "실제 변경"으로 보지 않는다 — 이미 버전 커밋된 상태이므로 이후 추가 변경이 없으면 skip.metadata.version은 하나 이상의 플러그인이 업그레이드될 때만 범프.깔끔하고 전문적인 HTML 기반 발표자료를 단일 파일로 생성한다. deck(페이지 넘김) 엔진 기반의 인터랙티브 프레젠테이션으로, 슬라이드 라이브러리 없이 순수 HTML+CSS+바닐라 JS로 구현한다. 해상도 독립 16:9, 키보드/터치/진행바 네비게이션, 발표자 보기, 등장 애니메이션, 라이트박스, 비디오, 발표자 노트를 콘텐츠에 따라 자동 적용한다. 다크/라이트 테마, highlight.js 코드 블럭을 지원하며 frontend-design 스킬 연동으로 화려한 비주얼도 선택 가능하다. 트리거: "make a presentation", "create slides", "build a deck", "발표자료", "프레젠테이션", "슬라이드", "제안서", "발표 만들어", "ppt", "keynote", "pitch deck", "tech talk", "발표 만들어줘".
회의록에 적히는 문장을 팀원이 한 번에 읽히도록 풀어 쓰거나 감사(audit)할 때 사용한다. 줄글 벽·과잉 기록·모호한 상태 표기('논의함'으로 끝나 결과를 알 수 없는 문장)·보고서 말투를 걷어내되, 시스템명·도메인 용어는 그대로 둔다. 문장 품질만 다룬다 — 섹션 구성·양식 같은 회의록 구조는 팀 포맷의 몫이고, 녹취록 변환·발화자 귀속·원문 대조 같은 사실 충실도는 별도 기능의 몫이다. 위키 최종본은 yowu-write-wiki, 기술 문서·PR은 yowu-write-tech, 에세이·회고는 yowu-write-essay를 쓴다. 트리거 - "회의록 다듬어", "회의록 읽기 쉽게 정리", "회의록 문장 정리", "미팅노트 다듬기", "회의 결정사항 문장 정리", "write meeting", "회의록 감사/검토".
에세이·블로그·포스트·회고에 적합한 글로 풀어 쓰거나 감사(audit)할 때 사용한다. AI 특유의 매끈하지만 공허한 문체를 걷어내고, 구체적 경험과 목소리가 있는 읽기 쉬운 글을 만든다. 기술 문서·PR 설명은 yowu-write-tech, 위키·사내 문서는 yowu-write-wiki를 쓴다. 트리거 - "에세이로 써줘", "블로그 글 작성", "포스트로 정리", "회고 작성", "write essay", "블로그에 올릴 글", "블로그 글 다듬어줘", "사람이 쓴 것처럼".
기술적인 글·문장을 장황하지 않게 풀어 쓰거나 감사(audit)할 때 사용한다. 설계 문서, 기술 설명, PR 설명, 코드 리뷰 코멘트, README, 장애 보고서, 기술 답변이 대상. 기술 용어·전문 용어·코드 식별자는 그대로 유지하고, 그 주변 문장만 사람이 읽기 쉽게 푼다. 위키·컨플루언스에 올릴 문서는 yowu-write-wiki, 에세이·블로그·회고는 yowu-write-essay를 쓴다. 트리거 - "기술 문서 풀어써", "기술 글 다듬어", "읽기 쉽게 써줘", "write tech", "기술 문장 정리", "설계 문서 작성", "PR 설명 작성", "장황한 문장 고쳐줘".
위키·컨플루언스·사내 문서에 올리기 적합한 글로 풀어 쓰거나 감사(audit)할 때 사용한다. 검색으로 유입되는 미래의 독자를 위해 자기완결적이고 스캔 가능한 문서를 만든다. 기술 용어·도메인 언어·전문 용어는 유지한 채 문장만 쉽게 푼다. 글의 품질만 다루며, 위키·컨플루언스에 실제로 등록·발행하는 작업은 이 스킬의 범위가 아니다(발행은 별도 도구의 몫). 트리거 - "위키 문서로 정리", "위키에 올릴 글", "컨플루언스에 올릴 문서 다듬기", "wiki 정리", "write wiki", "온보딩 문서 다듬기", "운영 문서 정리", "위키용으로 문서화".
Gemini CLI를 활용한 HTML 디자인 리뷰 스킬. 생성된 HTML 파일을 Gemini에게 전달하여 시각 디자인 개선 지침을 받고, 메인 세션에서 CSS/HTML을 수정한다. gemini CLI 미설치 시 quiet pass. 트리거: "디자인 리뷰", "gemini review", "design review", "디자인 검토", "디자인 보완".