DariyXYZ/codex-skill-toolkit-for-claude

Claude to Codex Skill Toolkit

목적

Claude-to-Codex 스킬 전체 수명 주기를 처리합니다:

• GitHub 저장소 또는 로컬 스킬 폴더 검사
• .claude/skills/<name>/skill.md를 수동으로 생성하는 셸 스니펫 검사
• 최단 안전 경로 선택: 직접 설치 또는 마이그레이션
• 사용자가 Claude 튜토리얼에서 찾은 설치 힌트 분류
• 실행 전 호환성 점수, 의존성 위험 및 설치 계층 평가
• 필요한 경우 디스커버리 핵심 메타데이터 재작성
• Codex가 실제로 결과를 발견할 수 있는지 검증
• 완성된 스킬을 재사용 또는 GitHub 게시용으로 패키징

이 스킬은 일회성 설치와 재사용 가능하고 세련된 Codex 네이티브 포트를 구축하는 데 모두 사용하십시오.

자동 트리거

다음과 같은 요청에 포함된 아이디어가 있을 때 활성화됩니다:

• 이 Claude 스킬을 Codex에 설치
• 이 Claude Code 스킬을 마이그레이션
• 이 스킬을 Codex로 포팅
• 이 스킬을 Codex에 맞게 조정
• 이 mkdir/printf .claude/skills/.../skill.md 명령이 실제로 스킬을 설치할까요?
• 설치된 이 스킬이 왜 표시되지 않나요?
• 마이그레이션된 이 스킬을 GitHub용으로 패키징
• 이 Claude 스킬이 Codex에서 작동할지 검토

사용자가 "이 스킬 설치"라고 말하고 링크만 붙여넣어도 다음을 직접 Claude 지향 신호로 처리합니다:

• GitHub URL 또는 anthropics/, 특히 anthropics/skills의 owner/repo 참조
• Claude, Claude Code, Anthropic 또는 anthropics를 언급하는 URL, 저장소 이름 또는 텍스트
• .claude/skills, .claude-plugin, skill.json 또는 marketplace.json을 포함하는 경로 또는 스니펫
• /plugin marketplace add, /plugin install, 또는 /plugin add 같은 명령어
• Claude 전용 ZIP 업로드 흐름 또는 Skills API 참조

해당 표시 중 하나라도 있으면 원시 직접 설치에 의존하기 전에 이 스킬을 먼저 사용하십시오.

빠른 경로 선택

가장 짧으면서도 신뢰할 수 있는 경로를 선택하십시오.

1. 저장소에 이미 깨끗한 SKILL.md가 있고 폴더 레이아웃이 명확하면 정확한 스킬 폴더를 먼저 설치한 다음 디스커버리를 검증합니다.
2. 저장소에 .claude/skills, .claude-plugin 또는 skill.json과 같은 플랫폼별 레이아웃이 포함되어 있으면 설치 불가능으로 결정하기 전에 해당 신호를 검사합니다.
3. 사용자가 .claude/skills/<name>/skill.md를 생성하는 셸 스니펫을 제공하면 로컬 스캐폴드로 처리하고 생성된 폴더를 검사한 후 설치되었다고 간주합니다.
4. 저장소가 Claude 전용이거나, 모호하거나, 다중 스킬이거나, 여전히 Claude 전용 가정을 사용하는 경우 성공을 주장하기 전에 마이그레이션합니다.
5. 작업이 평가만인 경우 저장소를 검사하고 아무것도 설치하지 않고 호환성을 설명합니다.
6. 사용자가 공유 가능한 아티팩트를 원하는 경우 최소 구조와 검증 노트가 포함된 깔끔한 Codex 네이티브 패키지를 빌드합니다.

로컬 폴더를 사용할 수 있고 저장소 레이아웃이 명확하지 않은 경우 scripts/inspect_skill_repo.py를 사용하십시오. 프론트매터 또는 BOM 문제를 결정적으로 확인해야 하는 경우 scripts/check_skill_md.py를 사용하십시오. 사용자가 Claude 튜토리얼 명령어 또는 설치 스니펫을 붙여넣고 Codex 경로에 매핑해야 하는 경우 scripts/classify_install_hint.py를 사용하십시오. 설치 가능성이 좋아 보이지만 실제 사용자 프롬프트와 잘 일치할지 알아야 하는 경우 scripts/trigger_score.py를 사용하십시오. 각 설치 검토 후 읽기 쉬운 Markdown 분석을 남기려면 scripts/generate_install_report.py를 사용하십시오. 선택한 로컬 스킬을 Codex에 복사할 수도 있는 반자동 경로 선택기를 원하는 경우 scripts/install_skill_flow.py를 사용하십시오.

핵심 워크플로우

1. 소스 검사. 저장소 레이아웃을 읽고, skills/, SKILL.md, 도우미 스크립트 및 Claude 전용 패키징 가정을 찾습니다.

2. 경로 결정. references/compatibility-matrix.md를 사용하여 직접 설치, 가벼운 적응 또는 전체 마이그레이션 중에서 결정합니다. 사용자가 튜토리얼 명령어를 복사한 경우 references/install-route-adaptation.md로 먼저 정규화합니다.

3. 가장 작은 실행 가능한 변경 수행.

• 소스가 이미 Codex 친화적인 경우 직접 설치합니다.
• 디스커버리 또는 트리거 품질이 약한 경우 SKILL.md 및 지원 파일을 재작성합니다.
• 내구성 있는 Codex 포트를 구축할 때 긴 안내를 references/로 분할합니다.
• 호환성 점수와 설치 계층을 사용하여 경로가 안전하거나 위험한 이유를 설명합니다.
• 결과를 나중에 검토하거나, 공유하거나, 마이그레이션 기록으로 사용할 때마다 설치 보고서를 생성합니다.

4. 가정하지 말고 검증하십시오. 항상 확인하십시오:

• 스킬 폴더가 의도된 위치에 존재하는지
• SKILL.md가 파서 친화적인지
• 파일이 BOM 없는 UTF-8인지
• 대상이 라이브 Codex 설치인 경우 codex debug prompt-input이 스킬을 노출하는지

5. 요청 시 깔끔하게 패키징하십시오. GitHub 또는 공유를 위해 하나의 표준 스킬 폴더를 유지하십시오:

• SKILL.md
• 유용한 경우 agents/openai.yaml
• 요청 시 로드할 가치가 있는 자료만 references/
• 결정론적 도우미만 scripts/

GitHub 스킬 저장소 빠른 경로

사용자가 GitHub 저장소 또는 스킬 URL을 제공하는 경우:

1. 먼저 저장소 루트와 skills/를 검사합니다.
2. 저장소가 문서나 카탈로그일 뿐이라고 결정하기 전에 .claude/skills, 루트 skill.json 및 .claude-plugin/plugin.json도 검사합니다.
3. 저장소, 소유자, 경로 또는 주변 텍스트에 anthropics/skills, Claude, Anthropic 또는 .claude/*와 같은 Claude 지향 신호가 포함된 경우 스킬 경로가 명확해 보일지라도 이 툴킷 흐름을 유지합니다.
4. 대상 경로가 명확한 경우 전체 저장소가 아닌 정확한 스킬 폴더를 설치합니다.
5. 설치 직후 설치된 SKILL.md를 읽습니다.
6. 디스커버리가 이미 깨끗하고 트리거 품질이 허용 가능한 경우 중단합니다.
7. 설치된 스킬이 보이지 않거나, 이름이 모호하거나, 형식이 잘못되었거나, 설명이 약하거나, 여전히 Claude 전용인 경우 마이그레이션으로 전환합니다.

경로를 자신 있게 추론할 수 있을 때 정확한 --repo 및 --path 설치에 치우칩니다.

로컬 Claude 셸 스니펫 빠른 경로

사용자가 mkdir ... .claude/skills/... && printf ... > skill.md와 같은 셸 스니펫을 제공하는 경우:

1. 게시된 스킬이 설치되었다는 증거가 아닌 로컬 스캐폴드로 처리합니다.
2. 생성된 폴더를 직접 검사합니다.
3. skill.md 또는 Skill.md를 SKILL.md로 정규화합니다.
4. 필요한 경우 Markdown 메타데이터 섹션을 YAML 프론트매터로 변환합니다.
5. 정규화 후에야 스킬이 Codex 준비되었다고 주장해야 합니다.

마이그레이션 규칙

마이그레이션이 필요한 경우:

1. 원래 패키징이 아닌 동작을 보존합니다.
2. name과 description이 기능과 트리거 구문을 모두 명확하게 표현하도록 프론트매터를 다시 작성합니다.
3. 본문을 간결하고 실용적으로 유지합니다.
4. 긴 플레이북, 매핑 및 문제 해결을 references/로 이동합니다.
5. 실제 디스커버리 이유가 없는 한 중복 별칭을 피합니다.

전체 순서는 references/migration-playbook.md를 읽으십시오.

디스커버리 규칙

• "디스크에 설치되었지만 codex debug prompt-input에 없음"을 실패한 설치로 처리합니다.
• SKILL.md를 BOM 없는 UTF-8로 저장합니다.
• 스킬당 하나의 표준 폴더를 선호합니다.
• 프론트매터를 간단하게 유지합니다.
• description을 Codex가 실제 사용자 표현과 일치할 수 있도록 트리거가 풍부하게 만듭니다.

디스커버리가 손상된 경우 references/discovery-troubleshooting.md를 사용하십시오.

패키징 규칙

공유 가능한 Codex 네이티브 포트를 구축할 때:

• 표준 스킬 폴더 자체를 게시합니다.
• 사용자가 명시적으로 저장소용 문서를 원하지 않는 한 추가 문서 파일을 피합니다.
• 도우미 스크립트를 일반적이고 결정론적으로 유지합니다.
• 동일한 스킬의 중복 마이그레이션 변형을 배송하지 마십시오.
• 저장소에 여러 스킬이 포함된 경우 각각을 별도의 스킬 폴더로 패키징합니다.

필수 검증

마이그레이션이 완료되었다고 말하기 전에 확인하십시오:

• scripts/check_skill_md.py <path-to-skill-md>가 차단 문제를 보고하지 않는지
• scripts/inspect_skill_repo.py <path-to-skill-folder>가 예상 구조를 보여주는지
• 호환성 점수, 의존성 프로필 및 설치 계층이 선택한 경로에 적합한지
• 트리거 품질이 현실적인 프롬프트에 충분히 좋은지, 또는 보고서가 마이그레이션 정리가 여전히 필요한 이유를 명확히 설명하는지
• codex debug prompt-input이 라이브 Codex 스킬 디렉토리에 설치될 때 스킬을 표시하는지

참조 가이드

필요한 것만 읽으십시오:

• references/migration-playbook.md — 종단간 마이그레이션 순서
• references/compatibility-matrix.md — 경로 선택
• references/install-route-adaptation.md — Claude 설치 튜토리얼을 Codex 작업으로 변환
• references/install-workflow.md — 반자동 설치 프로그램 패턴
• references/discovery-troubleshooting.md — 실패 분석