공개 스킬 패키지
비공개 스킬을 공개 GitHub 릴리스로 전환하는 릴리스 파이프라인을 실행합니다. 파이프라인 순서는 고정되어 있습니다: 평가 → 정리 → 문서화 → 테마 → 패키징 → 스테이징. 정리 단계를 건너뛰지 마십시오. 해결되지 않은 정리 결과가 있으면 아무것도 배송되지 않습니다.
1. 평가
registry/pipeline.md의 네 가지 질문에 답하십시오(설치할 가치가 있는가? 독립형인가? 정리 가능한가? 한 페이지로 설명 가능한가?). "아니오"인 경우 → 중단, 장애물 보고, 스킬을 비공개로 유지합니다. 평결을 레지스트리에 기록하십시오.
2. 정리
스캐너를 실행하고 계속하기 전에 모든 결과를 해결하십시오:
python3 scripts/scrub_personal.py <skill-dir>
- 개인 경로를 일반 경로로 바꾸십시오(
/Users/you/...,<your-project>/). - 개인 이름/이메일을 공개 브랜드 연락처 또는 자리 표시자로 바꾸십시오.
- 자격 증명을 완전히 제거하십시오 — 실제 비밀을 허용 목록에 절대 추가하지 마십시오.
- 종료 코드 0이 나올 때까지 다시 실행하십시오. 의도적인 공개 문자열(예: 브랜드 이름)에 대해서만
--allow를 사용하십시오.
3. 문서화
references/에서 후보 스킬 루트로 복사하고 모든 자리 표시자를 채우십시오:
readme-template.md→README.md(문제, 설치, 사용법, 라이선스)changelog-template.md→CHANGELOG.md, 첫 번째 항목## [1.0.0] - <오늘 날짜>LICENSE추가 — 소유자가 릴리스마다 선택합니다(오픈 또는 상업용). 저장소에 실제로 포함되지 않은 라이선스나 가격을 공개 페이지에 명시하지 마십시오.
4. 웹 페이지 테마 적용
assets/site-template/을 릴리스의 사이트 폴더로 복사하고 {{PLACEHOLDER}} 토큰(스킬 이름, 태그라인, 리포지토리 URL, 기능, 설치 명령)을 바꾸십시오. 팔레트, 글꼴 또는 레이아웃 규칙을 변경하지 마십시오 — styles.css의 헤더 주석에 브랜드 규칙이 문서화되어 있습니다(노란색 강조 없음, 글로우 블롭 없음, 네이비에 금색 텍스트 없음, 악센트에만 스크립트 글꼴 사용).
5. 패키징
구조를 검증하십시오(SKILL.md 프론트매터에 name + description이 있고, scripts/, references/, assets/ 리소스만 실제로 존재해야 합니다). 그런 다음 압축하십시오:
cd <staging-parent> && zip -r <skill-name>.skill <skill-name>
6. 스테이징 및 등록
- 정리된 폴더 +
.skillzip + 웹 페이지를releases/<skill-name>/으로 이동하십시오. registry/pipeline.md상태와 프로젝트CHANGELOG.md를 업데이트하십시오.- 보고: 무엇이 배송되었는지, 정리 결과, 남은 수동 단계(git init, GitHub 리포지토리 생성, 푸시 — 이 단계는 소유자의 승인과 자격 증명이 필요합니다).
전체 사전 비행 체크리스트는 references/release-checklist.md를 참조하십시오. 릴리스가 완료되었다고 선언하기 전에 모든 항목을 실행하십시오.