스킬 포지 컨버트

스킬 변환 — 멀티 플랫폼

Claude Code 스킬을 OpenAI Codex, Google Gemini CLI, Google Antigravity, Cursor에서 사용할 수 있도록 변환하며, 품질을 유지하고 각 플랫폼의 모범 사례를 따릅니다.

프로세스

1단계: 소스 스킬 읽기

1. 소스 SKILL.md를 읽고 프론트매터를 파싱합니다.
2. 스킬 복잡성 계층(1~4)을 감지합니다.
3. 모든 파일을 인벤토리화합니다: scripts/, references/, agents/, 서브스킬
4. MCP 설정(.mcp.json)이 있으면 식별합니다.

2단계: 플랫폼 호환성 분석

먼저 dry-run 분석을 실행합니다.

python scripts/convert_skill.py <path> --dry-run --target all

호환성 리포트를 검토합니다.

• 이식 가능 필드: 직접 전송 (이름, 설명, 라이선스)
• 적응 가능 필드: 플랫폼별 처리 필요
• Claude 전용 필드: 경고와 함께 제거됨

3단계: 대상 플랫폼으로 변환

변환을 실행합니다.

python scripts/convert_skill.py <path> --target codex,gemini,antigravity,cursor --output dist/

MCP 설정 변환의 경우:

python scripts/convert_skill.py <path> --target all --output dist/ --include-mcp

4단계: Claude 전용 기능 처리

플랫폼별로 수동 적응이 필요한 기능입니다.

Claude 기능	Codex	Gemini/Antigravity	Cursor
allowed-tools	지원됨	제거; 모든 도구 사용 가능	제거; 동등한 기능 없음
context: fork	동등한 기능 없음	동등한 기능 없음	동등한 기능 없음
hooks	1개 이벤트 (notify)	부분 지원 (CLI)	6개 이벤트 (베타)
model 선택	동등한 기능 없음	동등한 기능 없음	동등한 기능 없음
Task 위임	별도 스킬로 분할	별도 스킬로 분할	백그라운드 에이전트 (Ultra 요금제)
/slash 명령어	$mention 구문	설명 기반 활성화	설명 기반 + @rule
서브스킬 라우팅	$mention으로 별도 스킬	별도 스킬, LLM 라우팅	별도 스킬, LLM 라우팅

5단계: 변환된 스킬 검증

생성된 각 출력에 대해 유효성 검사를 실행합니다.

python scripts/validate_skill.py dist/codex/<skill-name>/
python scripts/validate_skill.py dist/gemini/<skill-name>/
python scripts/validate_skill.py dist/antigravity/<skill-name>/
python scripts/validate_skill.py dist/cursor/<skill-name>/

진행하기 전에 모든 중요 또는 높은 우선순위 문제를 수정합니다.

6단계: 배포 보고서 생성

사용자에게 요약을 제시합니다.

## 변환 보고서: {skill-name}

| 플랫폼 | 점수 | 파일 | 경고 | 수동 단계 |
|----------|-------|-------|----------|-------------|
| Codex | 92% | 4 | 2 | 1 |
| Gemini | 88% | 3 | 3 | 1 |
| Antigravity | 88% | 3 | 3 | 1 |
| Cursor | 88% | 3 | 3 | 1 |

### 생성된 파일
[플랫폼별 목록]

### 경고
[플랫폼별 목록]

### 필요 수동 단계
[플랫폼별 목록]

7단계: 멀티 플랫폼 설치 스크립트 생성

모든 플랫폼(--target all)으로 변환할 때 스크립트가 자동으로 install-multiplatform.sh를 생성합니다.

• 현재 에이전트 플랫폼을 자동 감지합니다.
• 올바른 스킬 경로에 설치합니다.
• 명시적 선택을 위해 --platform 플래그를 지원합니다.

플랫폼 빠른 참조

플랫폼	스킬 경로	명령 파일	설정 형식
Claude Code	.claude/skills/	CLAUDE.md	JSON (.mcp.json)
OpenAI Codex	.agents/skills/	AGENTS.md	TOML (config.toml)
Gemini CLI	.gemini/skills/	GEMINI.md	JSON (settings.json)
Antigravity	.agent/skills/	GEMINI.md	JSON (mcp_config.json)
Cursor	.cursor/skills/	.cursor/rules/*.mdc	JSON (mcp.json)

전체 플랫폼 사양은 references/platforms.md를 참조하세요.

계층 변환 지침

• 계층 1 (단일 SKILL.md): 깔끔하게 변환됩니다. 자동 변환 권장.
• 계층 2 (스킬 + 스크립트): 잘 변환됩니다. 스크립트 경로를 확인하세요.
• 계층 3 (멀티 스킬): 부분 지원. 각 서브스킬이 독립적으로 변환됩니다. 라우팅은 수동 작업이 필요합니다.
• 계층 4 (생태계): 수동 검토 필요. 서브에이전트 위임은 플랫폼 적응이 필요합니다.