스킬 출판 및 배포

스킬 출판 및 배포은(는) 무엇을 하나요?

프로세스

1단계: 출판 전 검증

출판 전에 전체 검토를 실행하세요:

1. /skill-forge review <경로>를 실행하여 점수가 80/100 이상인지 확인
2. 모든 중요 또는 우선순위 문제 수정
3. 최소 5개의 트리거 질문으로 테스트
4. 모든 상호 참조가 제대로 연결되는지 확인

2단계: 설치 스크립트 생성

다음과 같은 install.sh를 생성하세요:

#!/usr/bin/env bash
# [스킬 이름] 설치 스크립트
# 사용법: bash install.sh

set -euo pipefail

SKILL_DIR="$HOME/.claude/skills"
AGENT_DIR="$HOME/.claude/agents"
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

echo "[스킬 이름] 스킬 설치 중..."

# 디렉토리 생성
mkdir -p "$SKILL_DIR" "$AGENT_DIR"

# 메인 스킬 복사
cp -r "$SCRIPT_DIR/skill-name" "$SKILL_DIR/"
echo "  설치됨: skill-name"

# 하위 스킬 복사
for skill in "$SCRIPT_DIR/skills"/skill-name-*/; do
    if [ -d "$skill" ]; then
        skill_basename=$(basename "$skill")
        cp -r "$skill" "$SKILL_DIR/"
        echo "  설치됨: $skill_basename"
    fi
done

# 에이전트 복사 (있는 경우)
if [ -d "$SCRIPT_DIR/agents" ]; then
    cp "$SCRIPT_DIR/agents"/*.md "$AGENT_DIR/" 2>/dev/null || true
    echo "  에이전트 설치됨"
fi

echo ""
echo "설치 완료!"
echo "테스트: /skill-name"

3단계: README.md 생성 (저장소 수준, 스킬 폴더 내부 아님)

# [스킬 이름]

[결과 중심의 1-2문장 설명]

## 기능

[핵심 기능 목록]

## 설치

### Claude Code

git clone https://github.com/[사용자]/[저장소] cd [저장소] bash install.sh

### Claude.ai
1. 최신 릴리스(.zip) 다운로드
2. 설정 > 기능 > 스킬로 이동
3. "스킬 업로드" 클릭
4. 다운로드한 .zip 파일 선택

## 명령어

| 명령어 | 설명 |
|--------|------|
| `/skill-name` | [설명] |
| `/skill-name cmd` | [설명] |

## 예제

### [예제 1 제목]

사용자: "[예제 입력]"

[발생하는 작업 및 예상 출력 설명]

## 아키텍처

[파일 트리 다이어그램]

## 라이선스

[라이선스 유형]

4단계: 배포용 패키징

Claude.ai 업로드용: python scripts/package_skill.py <경로> <출력-디렉토리>를 실행하여 .skill zip 파일 생성.

GitHub용:

1. 루트에 README.md가 있는 저장소 생성
2. 루트 레벨에 스킬 폴더 배치
3. 루트 레벨에 install.sh 배치
4. LICENSE 파일 추가
5. .gitignore 추가 (.tmp/, pycache/, *.pyc 제외)

팀 배포용 (Claude.ai 관리자):

• 관리자가 작업 공간 전체에 스킬을 배포 가능
• .skill zip으로 패키징하여 관리자 콘솔을 통해 업로드

5단계: .gitignore 생성

__pycache__/
*.pyc
*.pyo
.tmp/
*.egg-info/
dist/
build/
.env
*.skill

6단계: 릴리스 체크리스트

• 모든 파일 검증 완료 (점수 >= 80)
• install.sh가 깨끗한 시스템에서 테스트됨
• README.md에 설치, 사용법, 예제 포함
• LICENSE 파일 포함
• .gitignore 설정됨
• 어떤 파일에도 비밀 키 또는 API 키 없음
• 테스트 질문 문서화됨
• 버전 태그 지정됨 (git 사용 시)

7단계: 출판 후

출판 후:

1. 깨끗한 환경에서 처음부터 설치 테스트
2. 모든 트리거 테스트 질문 실행
3. 초기 사용자 피드백 수집
4. 피드백 기반 첫 번째 개선 계획 수립
5. 버그 보고용 이슈 템플릿 설정

배포 채널

채널	적합 대상	형식
GitHub	오픈 소스, 커뮤니티	저장소 + install.sh
Claude.ai 업로드	개인 사용	.skill zip
팀 관리자	조직 전체	.skill zip (관리자 콘솔 통해)
Claude 플러그인 마켓플레이스	광범위 배포	.claude-plugin/ 매니페스트