스킬 오픈소서

스킬 오픈소서은(는) 무엇을 하나요?

로컬 스킬 하나를 깔끔한 공개 릴리스 패키지로 변환합니다. 일반적인 입력은 SKILL.md 경로 또는 스킬 디렉토리입니다.

기본 자세: 빠르게 움직이되 릴리스 위험이 있으면 멈춥니다. 보안 스캔에서 비밀, 개인 경로, 클라이언트 데이터, 미공개 독점 자료 또는 소유권이 불분명한 내용이 발견되면 차단 요소를 보고하고 사용자가 해결할 때까지 발행하지 않습니다.

빠른 시작

1. 입력을 실제 스킬 디렉토리로 변환합니다. SKILL.md 파일, SKILL.md가 포함된 폴더, 또는 .codex/skills, .agents/skills, .claude/skills 또는 다른 로컬 스킬 루트 아래의 심볼릭 링크를 허용합니다.
2. 패키징 또는 퍼블리싱 전에 환경 검사를 실행합니다:

SKILL_OPEN_SOURCER_DIR="${CODEX_HOME:-$HOME/.codex}/skills/skill-open-sourcer"
python3 "$SKILL_OPEN_SOURCER_DIR/scripts/check_release_env.py"

필요한 로컬 명령어는 python3, git, node, npx입니다. gh는 기본 로컬 GitHub 퍼블리싱 인터페이스이지만, GitHub MCP/앱 또는 기존 인증된 원격 저장소로 대체할 수 있습니다. GitHub 퍼블리싱 인터페이스를 사용할 수 없는 경우 로컬에서 저장소를 빌드하고 검증한 후 설정 누락과 함께 중단합니다.

3. 스킬 진입점을 읽고 직접 참조된 scripts/, references/, assets/, agents/ 파일을 검사합니다. 관련 없는 로컬 폴더는 복사하지 마십시오.
4. 보안 스캐너를 실행합니다:

SKILL_OPEN_SOURCER_DIR="${CODEX_HOME:-$HOME/.codex}/skills/skill-open-sourcer"
python3 "$SKILL_OPEN_SOURCER_DIR/scripts/scan_skill_release.py" /path/to/skill-or-SKILL.md

5. 환경 및 보안 검사가 통과되면 소스 스킬 디렉토리 외부에 새 릴리스 저장소를 만듭니다.
6. 단일 스킬 저장소의 경우 SKILL.md, agents/, references/, scripts/, assets/를 저장소 루트에 직접 복사합니다. 다중 스킬 컬렉션 저장소에만 skills/<skill-name>/과 skills.sh.json을 사용합니다.
7. references/release-package.md에 설명된 공개 릴리스 파일을 추가합니다. 여기에는 README 품질 게이트 및 GitHub 메타데이터 권장 사항이 포함됩니다.
8. 퍼블리싱 전에 패키징된 스킬과 npx skills 목록을 검증합니다.
9. 낮은 위험 검사가 통과되면 GitHub에 퍼블리싱한 후 런치 카피를 생성합니다.

릴리스 저장소를 작성하기 전에 references/release-package.md를 읽으십시오.

출력 계약

성공적인 릴리스의 경우 다음을 반환합니다:

• GitHub 저장소 URL.
• npx skills를 사용한 설치 명령어.
• 스킬 검증 및 npx skills add <owner>/<repo> --list에 대한 검증 결과.
• 간단한 위험 요약: 스캔한 항목, 제거 또는 정리된 항목, 그리고 남은 가정 사항.
• 새 공개 저장소를 생성할 때의 GitHub 설명 및 토픽 권장 사항.
• 런치 카피: X/Twitter 게시물 최소 1개, 사용자가 중국어로 작업하는 경우 선택적 중국어 버전.

차단된 경우 다음을 반환합니다:

• 파일 경로와 이유가 포함된 차단 요소 목록.
• 제안된 정리 단계.
• 가장 안전한 다음 작업 (일반적으로 "이 파일들을 정리한 후 릴리스를 다시 실행하십시오").

안전 규칙

소스 패키지에 다음 중 하나라도 나타나면 하드 스톱합니다:

• API 키, 토큰, 개인 키, 쿠키, 자격 증명, .env 파일 또는 인증 설정.
• /Users/..., /home/...와 같은 절대 개인 경로, 로컬 볼트 경로 또는 공개 사용자를 혼동시킬 수 있는 시스템 전용 캐시 경로.
• 고객 이름, 회사 비공개 데이터, 내부 문서, 비공개 URL, 미공개 프롬프트, 또는 명확한 라이선스가 없는 유료/독점 자산.
• 패키지를 벗어나는 심볼릭 링크, 대용량 바이너리, 데이터베이스, 로그, 브라우저 프로필, .DS_Store, __pycache__ 또는 생성된 캐시 파일.
• 번들된 코드/자산에 대한 라이선스 또는 소유권이 불분명한 경우.

스캐너와 수동 검토에서 차단 요소가 발견되지 않은 경우에만 낮은 위험 자동 퍼블리싱이 허용됩니다. 대상 GitHub 저장소에 관련 없는 콘텐츠가 이미 존재하는 경우 덮어쓰거나 강제 푸시하기 전에 중단하고 사용자에게 문의하십시오.

패키징 규칙

• 원래 스킬 동작을 그대로 유지합니다. 개인적인 가정을 제거하고 공개 설치를 안정적으로 만들기에 충분한 정도로만 리팩터링합니다.
• 하나의 공개 스킬에는 기본적으로 평평한 루트 레이아웃을 사용합니다. 하나의 저장소가 여러 스킬을 게시하는 경우에만 중첩된 skills/<skill-name>/ 레이아웃을 사용합니다.
• 간결한 SKILL.md를 선호합니다. 자세한 공개 안내는 에이전트가 실제로 필요로 하는 경우에만 references/로 옮깁니다.
• 스킬 폴더 안에 README를 추가하지 마십시오. 사람을 위한 설명서는 릴리스 저장소 루트에 배치합니다.
• agents/openai.yaml이 있으면 보존합니다. 없으면 display_name, short_description, 그리고 $<skill-name>을 명시적으로 언급하는 default_prompt로 생성합니다.
• 스킬이 실제로 사용하는 결정적인 헬퍼 로직에만 scripts/를 포함합니다.
• 라이선스와 크기가 공개 릴리스에 안전한 경우에만 assets/를 포함합니다.
• 소스 스킬에 충돌하는 라이선스가 없고 소유권이 명확한 경우에만 MIT를 기본 라이선스로 사용합니다.

퍼블리싱 흐름

1. scripts/check_release_env.py를 실행합니다. 기존 로컬 저장소를 업데이트할 때는 --repo-dir <release-repo>를 추가합니다. 패키지/네트워크 접근이 불확실한 경우 --check-npx-skills를 추가합니다.
2. 필요한 명령어가 없으면 중단하고 정확한 차단 요소를 보고합니다. gh만 없는 경우 GitHub MCP/앱을 사용할 수 있거나 릴리스 저장소에 이미 인증된 origin 원격 저장소가 있는 경우에만 계속 진행합니다.
3. 로컬에서 릴리스 저장소를 빌드합니다.
4. 가능한 경우 시스템 스킬 검증기로 검증합니다:

python3 "${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-creator/scripts/quick_validate.py" .

5. 사용 가능한 GitHub 인터페이스(gh, GitHub MCP/앱 또는 기존 원격 저장소)를 사용하여 GitHub 저장소를 생성하거나 업데이트합니다. 강제 푸시는 피합니다.
6. 브랜치 또는 main을 푸시합니다.
7. 목록을 확인합니다:

npx skills add <owner>/<repo> --list

8. 목록이 작동하면 설치 명령어를 제공합니다:

npx skills add <owner>/<repo> -g -a codex --skill <skill-name> -y

대상 플랫폼이 Codex가 아닌 경우 에이전트 플래그와 설치 문구를 조정합니다.

런치 카피

성공적인 릴리스 후 다음을 설명하는 간결한 소셜 카피를 작성합니다:

• 스킬이 해결하는 문제.
• 사용자가 제공하는 것.
• 발행 또는 자동화하는 것.
• 설치 명령어 또는 저장소 링크.
• 구체적인 예시 요청 하나.

중국어 사용자의 경우 자연스러운 중국어 런치 게시물을 포함합니다. 사람을 위한 내용으로 유지하고 스크립트에 대해 과도하게 설명하지 마십시오.