agentleFS
Sign inStart free
ggombeeggombee/code-forge/skills/codex/SKILL.md

codex

Skill18 starsChanged 7 months agoMITView on GitHub

Claude + OpenAI Codex 협업 스킬. MCP 서버 설정 시에만 사용 가능.

  • Installs packages

135 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use ios-sync, compare-screenshots and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • Saqlain-811Skill

    ios-sync

    Regenerate the iOS debug bridge against the latest upstream gstack templates. (gstack)

    Also in 6 projects that use this

  • transitive-bullshitSkill

    compare-screenshots

    Compare screenshots against the intended design, distinguishing approved references from historical baselines. Use for iterative implementation matching, before/after visual review, objective image telemetry, or checking a lone capture for flat, empty, or badly framed content.

    Also in 5 projects that use this

  • dzhngSkill

    implement-spec-with-codex

    Run [implement-spec](../implement-spec/SKILL.md) with Codex doing the implementation passes while you orchestrate, integrate, and review. Use when the user asks to implement a spec with Codex, or to run implement-spec with Codex as the implementer.

    Also in 4 projects that use this

  • Saqlain-811Skill

    ios-clean

    Remove the DebugBridge SPM package and all #if DEBUG wiring from an iOS app. (gstack)

    Also in 5 projects that use this

  • john-data-chenSkill

    touchdesigner-mcp

    Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.

    Also in 7 projects that use this

  • math-incSkill

    minecraft-modpack-server

    Set up a modded Minecraft server from a CurseForge/Modrinth server pack zip. Covers NeoForge/Forge install, Java version, JVM tuning, firewall, LAN config, backups, and launch scripts.

    Also in 5 projects that use this

  • +1 more from Saqlain-811

The file

Create a free account to mount
Files
SKILL.md

Codex Pair Programming

Claude + OpenAI Codex 협업 스킬. MCP 서버 설정 시에만 사용 가능. OpenAI 공식 codex 플러그인(/codex:review 등)과의 역할 분리: docs/codex-coexistence.md

Prerequisites (전제 조건)

이 스킬은 codex MCP 서버가 설정된 경우에만 사용 가능합니다.

자동 감지 및 안내

스킬 실행 시 아래 순서로 확인한다:

  1. mcp__codex__codex 도구가 사용 가능한가? → MCP 모드로 진행
  2. which codex 실행 가능한가? → CLI Headless 모드로 진행
  3. 둘 다 불가 → 설정 안내 표시 후 종료:
Codex가 설정되어 있지 않습니다.

설정 방법은 docs/codex-mcp-setup-guide.md 를 참조하세요.
빠른 설정:
  1. codex CLI 설치: brew install openai-codex
  2. 인증: codex login
  3. .mcp.json에 MCP 서버 등록
  4. Claude Code 재시작

설정 가이드: @${CLAUDE_PLUGIN_ROOT}/docs/codex-mcp-setup-guide.md

설정 미완료 시 → 위 안내를 표시하고 스킬을 종료한다. 자동으로 설치를 강요하지 않는다.

MCP 도구

도구용도주요 파라미터
codex새 작업 시작dir, session_id, model, reasoning_effort
codex_reply기존 세션 이어서 작업session_id, 이전 컨텍스트 유지
codex_review코드 리뷰uncommitted 변경, 브랜치, 특정 커밋
list_sessions활성 세션 목록-
ping서버 상태 확인-

협업 모드

Mode 1: Solo+Review (기본)

Claude가 구현하고, Codex가 리뷰한다. 1-2개 파일 변경에 적합.

Claude: 코드 구현
  ↓
Codex (codex_review): 코드 리뷰, 엣지케이스 검증
  ↓
Claude: 피드백 반영

적합한 경우:

  • 단순 기능 추가/수정
  • 빠른 피드백이 필요할 때
  • 코드 품질 더블체크

Mode 2: Sequential (순차 협업)

Claude가 설계하고, Codex가 구현 + 테스트한다.

Claude: 아키텍처 설계, 인터페이스 정의
  ↓
Codex (codex): 구현 + 테스트 작성
  ↓
Claude: 결과 검증, 통합

적합한 경우:

  • 설계와 구현이 분리 가능한 작업
  • 테스트 커버리지가 중요한 작업

Mode 3: Parallel (병렬 협업)

Claude와 Codex가 서로 다른 파일을 동시에 작업한다.

Claude: 창의적/아키텍처 작업 (컴포넌트 설계, 상태 관리)
Codex (codex): 정밀 작업 (유틸 함수, 타입 정의, 테스트)

적합한 경우:

  • 대규모 작업에서 병렬 처리
  • 파일 수정 범위가 겹치지 않을 때

역할 분담

역할ClaudeCodex
아키텍처 설계O-
창의적 문제 해결O-
꼼꼼한 구현-O
엣지케이스 검증-O
코드 리뷰OO
테스트 작성OO

금지 사항

금지이유
MCP 미설정 상태에서 사용도구 없이 시뮬레이션 금지
동일 파일 동시 수정충돌 방지
Codex 출력 무검증 수용반드시 결과 확인 후 반영
MCP 미설정 사용자에게 설치 강요opt-in 원칙

필수 사항

필수기준
MCP 상태 확인작업 전 ping으로 연결 확인
세션 관리작업 완료 시 세션 정리
결과 검증Codex 출력은 반드시 검토 후 반영
파일 충돌 방지동시 수정 파일 명확히 분리

워크플로우 예시

기능 구현 + 리뷰 (Solo+Review)

1. Claude: 컴포넌트 구현
2. codex_review: 변경사항 리뷰 요청
3. Claude: 리뷰 피드백 반영
4. 완료

설계 → 구현 (Sequential)

1. Claude: 인터페이스/타입 설계, 파일 구조 결정
2. codex: "다음 인터페이스에 맞게 구현해줘" + 설계 내용 전달
3. codex_reply: 추가 요구사항 전달 (필요 시)
4. Claude: 결과 검증, lint/build 확인
5. 완료

에러 대응

에러원인해결
401 Unauthorized인증 만료codex login 재실행
세션 실패세션 손상새 세션으로 시작
MCP 연결 실패서버 미실행MCP 서버 재시작
도구 미발견MCP 미등록.claude/settings.json 확인

참고

  • 이 스킬은 완전 opt-in입니다. MCP 서버가 설정되지 않으면 아무 영향 없음
  • 팀원 중 Codex를 사용하지 않는 사람에게 설치를 강요하지 않음
  • Agent Teams에서 팀원으로 사용할 경우, general-purpose 타입으로 spawn 후 이 스킬을 읽도록 프롬프트에 지시
  • Codex 전용 에이전트도 별도 존재: agents/codex.md (Team Lead 역할 포함)

참조 문서

문서용도
agents/codex.mdCodex 에이전트 정의 (Team Lead 역할)
@${CLAUDE_PLUGIN_ROOT}/instructions/multi-agent/coordination-guide.md역할별 필수 참조 파일, 팀 템플릿
@${CLAUDE_PLUGIN_ROOT}/instructions/multi-agent/teammate-done-process.mdAgent Teams 팀원 완료 프로세스

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free