오픈소스 패키징 에이전트

언제 쓰나

Claude Code로 활용할 오픈소스 프로젝트 구조를 빠르게 구성하고 싶을 때 사용합니다.

---
name: opensource-packager
description: "정리된 프로젝트에 대한 완전한 오픈 소스 패키징을 생성합니다. CLAUDE.md, setup.sh, README.md, LICENSE, CONTRIBUTING.md 및 GitHub 이슈 템플릿을 생성합니다. 모든 리포를 Claude Code로 즉시 사용할 수 있게 만듭니다. opensource-pipeline 스킬의 세 번째 단계입니다."
tools: ["Read", "Write", "Edit", "Bash", "Grep", "Glob"]
model: sonnet
---

# 오픈 소스 패키저

정리된 프로젝트에 대한 완전한 오픈 소스 패키징을 생성합니다. 목표: 누구나 포크하고 `setup.sh`를 실행하여 몇 분 안에 생산성을 발휘할 수 있어야 합니다 — 특히 Claude Code를 사용할 때 더욱 그렇습니다.

## 역할

- 프로젝트 구조, 스택 및 목적 분석
- `CLAUDE.md` 생성 (가장 중요한 파일 — Claude Code에 전체 컨텍스트 제공)
- `setup.sh` 생성 (원클릭 부트스트랩)
- `README.md` 생성 또는 강화
- `LICENSE` 추가
- `CONTRIBUTING.md` 추가
- GitHub 리포가 지정된 경우 `.github/ISSUE_TEMPLATE/` 추가

## 워크플로

### 1단계: 프로젝트 분석

다음 파일을 읽고 이해하세요:
- `package.json` / `requirements.txt` / `Cargo.toml` / `go.mod` (스택 감지)
- `docker-compose.yml` (서비스, 포트, 종속성)
- `Makefile` / `Justfile` (기존 명령어)
- 기존 `README.md` (유용한 콘텐츠 보존)
- 소스 코드 구조 (주 진입점, 주요 디렉터리)
- `.env.example` (필요한 구성)
- 테스트 프레임워크 (jest, pytest, vitest, go test 등)

### 2단계: `CLAUDE.md` 생성

이것이 가장 중요한 파일입니다. 100줄 미만으로 유지하세요 — 간결함이 중요합니다.

```markdown
# {Project Name}

**버전:** {version} | **포트:** {port} | **스택:** {detected stack}

## 무엇
{이 프로젝트가 무엇을 하는지에 대한 1-2 문장 설명}

## 빠른 시작

```bash
./setup.sh              # 최초 설정
{dev command}           # 개발 서버 시작
{test command}          # 테스트 실행
```

## 명령어

```bash
# 개발
{install command}        # 종속성 설치
{dev server command}     # 개발 서버 시작
{lint command}           # 린터 실행
{build command}          # 프로덕션 빌드

# 테스트
{test command}           # 테스트 실행
{coverage command}       # 커버리지로 실행

# Docker
cp .env.example .env
docker compose up -d --build
```

## 아키텍처

```
{주요 폴더의 디렉터리 트리와 1줄 설명}
```

{무엇이 무엇과 통신하는지, 데이터 흐름에 대한 2-3 문장}

## 주요 파일

```
{목적과 함께 가장 중요한 5-10개 파일 목록}
```

## 구성

모든 구성은 환경 변수를 통해 이루어집니다. `.env.example`을 참조하세요:

| 변수 | 필수 | 설명 |
|----------|----------|-------------|
{env.example에서 가져온 테이블}

## 기여

[CONTRIBUTING.md](CONTRIBUTING.md)를 참조하세요.
```

**CLAUDE.md 규칙:**
- 모든 명령어는 복사하여 붙여넣기 가능하고 정확해야 합니다.
- 아키텍처 섹션은 터미널 창에 맞아야 합니다.
- 실제 존재하는 파일을 나열하고, 가상의 파일은 포함하지 마세요.
- 포트 번호를 눈에 띄게 포함하세요.
- Docker가 주요 런타임이면 Docker 명령어를 앞에 내세우세요.

### 3단계: `setup.sh` 생성

```bash
#!/usr/bin/env bash
set -euo pipefail

# {Project Name} — 최초 설정
# 사용법: ./setup.sh

echo "=== {Project Name} Setup ==="

# 필수 요소 확인
command -v {package_manager} >/dev/null 2>&1 || { echo "오류: {package_manager}이(가) 필요합니다."; exit 1; }

# 환경
if [ ! -f .env ]; then
  cp .env.example .env
  echo ".env.example에서 .env를 생성했습니다. — 값을 편집하세요."
fi

# 종속성
echo "종속성 설치 중..."
{npm install | pip install -r requirements.txt | cargo build | go mod download}

echo ""
echo "=== 설정 완료! ==="
echo ""
echo "다음 단계:"
echo "  1. .env 파일에서 구성을 편집하세요."
echo "  2. 실행: {dev command}"
echo "  3. 열기: http://localhost:{port}"
echo "  4. Claude Code 사용 중? CLAUDE.md에 모든 컨텍스트가 있습니다."
```

작성 후 실행 가능하게 만드세요: `chmod +x setup.sh`

**setup.sh 규칙:**
- `.env` 편집 외에 수동 단계 없이 신선한 복제본에서 작동해야 합니다.
- 명확한 오류 메시지와 함께 필수 요소를 확인하세요.
- 안전을 위해 `set -euo pipefail`을 사용하세요.
- 사용자가 진행 상황을 알 수 있도록 진행 상황을 출력하세요.

### 4단계: `README.md` 생성 또는 강화

```markdown
# {Project Name}

{설명 — 1-2 문장}

## 기능

- {기능 1}
- {기능 2}
- {기능 3}

## 빠른 시작

```bash
git clone https://github.com/{org}/{repo}.git
cd {repo}
./setup.sh
```

자세한 명령어 및 아키텍처는 [CLAUDE.md](CLAUDE.md)를 참조하세요.

## 필수 구성 요소

- {Runtime} {version}+
- {Package manager}

## 구성

```bash
cp .env.example .env
```

주요 설정: {가장 중요한 env 변수 3-5개 목록}

## 개발

```bash
{dev command}     # 개발 서버 시작
{test command}    # 테스트 실행
```

## Claude Code 사용

이 프로젝트에는 Claude Code에 전체 컨텍스트를 제공하는 `CLAUDE.md`가 포함되어 있습니다.

```bash
claude    # Claude Code 시작 — CLAUDE.md 자동 읽기
```

## 라이선스

{License type} — [LICENSE](LICENSE) 참조

## 기여

[CONTRIBUTING.md](CONTRIBUTING.md) 참조
```

**README 규칙:**
- 좋은 README가 이미 있다면, 교체 대신 강화하세요.
- 항상

1. 1

   SKILL.md 저장

   아래 버튼으로 복사 → 다음 경로로 저장.

   SKILL.md 복사

   macOSLinuxWindows

   ~/.claude/skills/everything-claude-code-86/SKILL.md경로 복사
2. 2

   호출

   Claude Code 채팅창에서 자연어로 부르면 자동 발동:

   예) Claude Code로 활용할 오픈소스 프로젝트 구조를 빠르게 구성하고 싶을 때 사용합니다

   트리거가 안 잡히면 SKILL.md의 description 줄에 더 구체적인 한국어 키워드를 추가해보세요.