virtual-insanity
← 리포트 목록

Codex skill learning guide 구축 보고

2026-04-10 codex ["codex", "skills", "plugins", "guide", "mcp", "skills-index", "codex-skill", "mcp-integration", "knowledge-agent"]

Codex skill learning guide 구축 보고

생성/수정 파일 목록

  • /Users/ron/.codex/AGENTS.md — Claude 스킬 인덱스 안내 섹션 append
  • /Users/ron/.codex/skills-index.md — Claude 스킬/플러그인/MCP 통합 인덱스 신규 생성
  • /Users/ron/knowledge-agent/400-reports/260410_codex_skill-learning-guide.md — 작업 보고서 신규 생성

인덱스 포함 스킬 수

  • 36개 (find ~/.claude/skills -name SKILL.md -type f | wc -l 기준)

추천 상위 10개

    1. error-resolve
    1. infra-ops
    1. pipeline-debug
    1. pipeline-create
    1. company-research
    1. vault-write
    1. get-api-docs
    1. yfinance-data
    1. graphify
    1. telegram-reader

수치 측정 방식

  • 활용 가능 스킬 수: 36 (find ~/.claude/skills -name SKILL.md -type f | wc -l 기준)
  • 최상위 디렉토리 수: 37 (find ~/.claude/skills -maxdepth 1 -type d | wc -l 결과 38에서 자기 자신 1 제외)
  • 현재 ~/.codex/skills-index.md 카탈로그 행 수: 43 (헤더 제외, 심볼릭 링크 경유 항목 포함)

플러그인 / MCP 비교 요약

  • Claude 설치 플러그인: claude-mem@thedotmack, everything-claude-code@everything-claude-code, superpowers@claude-plugins-official, telegram@claude-plugins-official, figma@claude-plugins-official, code-review-graph@code-review-graph
  • Claude 플러그인 MCP: code-review-graph, figma, mcp-search, telegram
  • Codex MCP: codex-self, workspace-fs, knowledge-memory, agent-bus
  • Codex 플러그인: github@openai-curated, gmail@openai-curated, google-calendar@openai-curated, google-drive@openai-curated
  • Codex 미연결 Claude MCP: code-review-graph, figma, mcp-search, telegram

검증

  • AGENTS 자동 로드 근거: ~/.codex/models_cache.json의 AGENTS 규칙 문자열에서 “CWD부터 root까지의 AGENTS.md를 developer message에 포함” 문구 확인
  • AGENTS bootstrap 근거: ~/.openclaw/workspace/health_logs/... 로그에서 workspace bootstrap file AGENTS.md 주입 흔적 확인
  • 임의 스킬 로드 검증: get-api-docs 경로를 인덱스에서 다시 읽어 실제 SKILL.md 헤더와 사용 순서가 정상 로드됨을 확인

잔여 검증 결과

1) 임의 스킬 실제 로드 재검증

  • company-research 재확인 경로: /Users/ron/.claude/skills/company-research/SKILL.md
  • 파일 존재 확인
  • frontmatter의 name: company-research 확인
  • 본문 헤더 # Company Research — 통합 기업·산업 리서치 확인
  • 이어지는 구조 ## 핵심 원칙## 경로 판단 확인
  • 결론: 인덱스에 적은 경로와 실제 본문 구조 일치
  • error-resolve 재확인 경로: /Users/ron/.claude/skills/error-resolve/SKILL.md
  • 파일 존재 확인
  • frontmatter의 name: error-resolve 확인
  • 본문 헤더 # Error Resolve (+ Cron Audit) 확인
  • 이어지는 구조 ## 진단 순서## Cron Audit 모드 확인
  • 결론: 인덱스에 적은 경로와 실제 본문 구조 일치

2) Codex vs Claude MCP 직접 diff

  • Codex ~/.codex/config.tomlmcp_servers
  • codex-self
  • workspace-fs
  • knowledge-memory
  • agent-bus
  • Claude 활성 MCP 설정 ~/.claude.json
  • agent-vault
  • context7
  • dart
  • kis-api
  • obsidian-vault
  • ron-pipeline
  • stealth-browser
  • telegram-mcp
  • Claude 설치 플러그인 manifest ~/.claude/plugins/.../.mcp.json
  • mcp-search (claude-mem@thedotmack)
  • telegram (telegram@claude-plugins-official)
  • figma (figma@claude-plugins-official)
  • code-review-graph (code-review-graph@code-review-graph)

직접 비교 결과

  • Codex ↔ Claude 활성 MCP(~/.claude.json) 겹침: 없음
  • Codex 전용 MCP: agent-bus, codex-self, knowledge-memory, workspace-fs
  • Claude 활성 전용 MCP: agent-vault, context7, dart, kis-api, obsidian-vault, ron-pipeline, stealth-browser, telegram-mcp
  • Codex ↔ Claude 플러그인 MCP(.mcp.json) 겹침: 없음
  • Claude 플러그인 전용 MCP: code-review-graph, figma, mcp-search, telegram

판정 전환

  • 이전 PARTIAL 사유 1번(임의 스킬 로드 미종결 문구): 닫힘
  • 이전 PARTIAL 사유 2번(플러그인/MCP 비교 미검증): ~/.codex/config.toml, ~/.claude.json, 설치 플러그인 .mcp.json 직접 대조로 닫힘
  • 최종 판정: PASS