헤파이스토스 오브 스킬 (skill-shipper)
작동하는 스킬을 낯선 사람이 설치하고 비용을 지불할 수 있는 릴리스로 만듭니다. 단계를 순서대로 실행하고, 오류가 있으면 중지한 후 수정하고 다음으로 넘어가세요.
모든 명령어는 이 스킬 폴더의 scripts/skillship.py를 사용합니다. Windows에서는 python, macOS/Linux에서는 python3입니다.
아래 경로는 이 스킬 폴더 기준 상대 경로이며, 사용자의 스킬 폴더는 <skill>로 전달하세요.
1. 린트
python scripts/skillship.py lint <skill>
- 오류(E-코드)는 릴리스를 차단합니다:
name누락/유효하지 않음, 이름이 폴더와 일치하지 않음, 설명 누락 또는 1024자 초과, 참조 파일 누락, 심볼릭 링크 등. - 경고(W-코드)는 판매나 트리거 성능을 저하시킵니다. 먼저 W023("Use when..." 누락)과 W022(설명 너무 짧음)를 수정하세요. 이 두 가지는 스킬이 전혀 실행되지 않는 일반적인 원인입니다.
- 전체 코드 목록과 수정 방법: references/lint-codes.md.
2. 설명 수정 (가장 중요한 단계)
references/description-playbook.md을 사용하여 설명을 다시 작성하세요: 무엇을 하는지, 그다음 "Use when...", 사용자가 실제로 입력하는 단어(동의어, 파일 유형, 도구 이름)를 포함하고, 인접한 스킬과 겹치는 경우 "Do NOT use for..." 경계를 추가하세요. 3인칭으로 유지하고 1024자 미만으로 작성하세요. 사용자에게 before/after를 보여주세요.
3. 트리거 테이블
<skill>/triggers.json을 생성합니다. 8-10개의 실행되어야 할(should-trigger) 프롬프트와 8-10개의 거의 일치하지만 실행되지 말아야 할(should-not-trigger) 프롬프트(형식은 플레이북 참조)를 포함하고 다음을 실행하세요:
python scripts/skillship.py triggers <skill>
이것은 모델 평가가 아닌 오프라인 어휘 검사입니다. BAD 행은 쿼리가 사용하는 용어 중 설명에 없는 용어를 나열합니다. 실제 용어를 추가하세요. 통과하면 실제 확인을 권장합니다: 각 프롬프트를 새로운 Claude Code 세션에서 3번 실행하고(또는 Anthropic의 skill-creator 평가 루프 사용) 스킬이 실행되는 횟수를 세세요. triggers.json은 빌드에서 제외됩니다.
4. 빌드
python scripts/skillship.py build <skill> --version 1.0.0 --author "이름" --out dist
dist/<name>-<version>/ 안에 다음을 생성합니다:
skill/<name>/-~/.claude/skills/, Cursor, Codex, OpenCode에 복사<name>-claude-ai.zip- claude.ai 설정 > 기능 > 스킬에서 업로드plugin-marketplace/- GitHub 저장소에 푸시; 사용자는/plugin marketplace add <owner>/<repo>를 실행한 후/plugin install <name>@<name>-marketplace를 실행- 모든 파일의 SHA-256과 함께
dist/<name>-<version>.zip
5. 릴리스 체크리스트
사용자와 함께 references/release-checklist.md(라이선스, README, 스크린샷/데모, 등록 위치, 가격 책정)를 확인하세요. 사용자의 명시적인 동의 없이 대신 게시, 업로드, 또는 게시글을 작성하지 마세요.
프로 팩
skill-shipper Pro는 별도 판매됩니다(<LS_URL>). skill-shipper-pro가 설치되어 있고 SKILLSHIP_LICENSE_KEY가 설정되어 있으면 구매자별 워터마킹, 유출 식별, 판매 페이지 초안 작성을 추가합니다. 키가 없으면 해당 기능이 Pro 기능이라고 말하고 무료 단계를 계속 진행하세요.