Name	Name	Last commit message	Last commit date
parent directory ..
prompts	prompts
template	template
AGENTS.md	AGENTS.md
README.md	README.md
install.ps1	install.ps1
install.sh	install.sh
user-global-AGENTS.md	user-global-AGENTS.md

plugin-mh — Codex Adapter

plugin-mh의 12개 스킬 + 2개 에이전트를 OpenAI Codex CLI에서 쓰기 위한 플러그인/어댑터 표면. 루트의 guardrails/ 는 TypeScript, Rust, Python, TDD, 리뷰, 소프트웨어 공학 법칙을 Codex 작업 규칙으로 제공한다.

호환성

환경	진입점	영향
Claude Code	`skills/`, `agents/`, `.claude-plugin/`	변경 없음 — 기존처럼 동작
Codex CLI	Codex plugin `plugin-mh@plugin-mh`	plugin cache에서 스킬 12개 + Codex prompt 14개를 한 표면으로 로드
Codex CLI legacy	`codex/prompts/` 와 `skills/` 를 `~/.codex/` 에 링크	플러그인 미사용 환경용 직접 연결 방식

한 저장소가 두 환경을 동시에 지원한다.

빠른 시작

1. 설치

기본 설치는 Codex plugin을 사용한다. 로컬 ~/.codex/skills junction과 함께 쓰면 같은 스킬이 중복 노출될 수 있으므로 둘 중 하나만 유지한다.

codex plugin marketplace add kingkingburger/plugin-mh
codex plugin add plugin-mh@plugin-mh

업데이트:

codex plugin marketplace upgrade plugin-mh

Legacy adapter 설치

Codex plugin을 쓸 수 없는 환경에서만 ~/.codex/prompts와 ~/.codex/skills에 직접 연결한다.

Windows (PowerShell)

.\codex\install.ps1

macOS / Linux

bash codex/install.sh

legacy adapter의 기본 동작은 prompts는 심볼릭 링크/하드링크, skills는 디렉터리 링크/junction 생성이다. 플러그인과 동시에 설치하면 중복 로딩될 수 있다.

복사 모드를 원하면 --copy 옵션:

.\codex\install.ps1 -Copy

bash codex/install.sh --copy

2. Codex CLI 재시작 후 확인

Codex CLI에서 / 입력 시 14개의 plugin-mh 명령어가 보여야 한다.

/agent-arena
/ai-slop-cleaner
/auto-commit
/closing-lite
/code-review
/find-pulp
/grill-me
/knowledge-curator
/live-verify
/ouroboros
/review-loop
/skill-manage
/tech-decision
/youtube-slides

Claude와 Codex 설치 표면까지 함께 검증하려면 다음을 실행한다. Codex만 확인하려면 -CodexInstalled / --codex-installed, Claude만 확인하려면 -ClaudeInstalled / --claude-installed를 쓴다.

.\scripts\validate-plugin.ps1 -Installed

bash scripts/validate-plugin.sh --installed

3. 사용 예시

/grill-me 사용자 인증 기능 추가하고 싶어
/tech-decision React Query vs SWR
/live-verify 로그인 플로우가 실제로 되는지 확인
/ouroboros 멀티테넌트 결제 시스템
/code-review

자연어로도 호출 가능하다 — Codex가 AGENTS.md 의 트리거 키워드 매핑을 보고 적절한 명령어를 선택한다.

디렉토리 구조

codex/
├── AGENTS.md                ← 14개 명령어 카탈로그 + 자연어 트리거 매핑
├── README.md                ← 본 파일
├── install.ps1              ← Windows legacy prompts + skills 설치 스크립트
├── install.sh               ← macOS/Linux legacy prompts + skills 설치 스크립트
├── user-global-AGENTS.md    ← 개인 글로벌 가이드 (~/.codex/AGENTS.md 용)
├── template/
│   └── AGENTS.md            ← 다른 프로젝트에 배포 가능한 워크플로우 템플릿
└── prompts/                 ← 14개 슬래시 커맨드 프롬프트
    ├── agent-arena.md
    ├── ai-slop-cleaner.md
    ├── auto-commit.md
    ├── closing-lite.md
    ├── code-review.md
    ├── find-pulp.md
    ├── grill-me.md
    ├── knowledge-curator.md
    ├── live-verify.md
    ├── ouroboros.md
    ├── review-loop.md
    ├── skill-manage.md
    ├── tech-decision.md
    └── youtube-slides.md

루트의 guardrails/ 는 Codex가 프로젝트별 AGENTS.md 다음으로 참고할 수 있는 개인 하네스 규칙이다.

하네스 (AGENTS.md) 활용

plugin-mh는 세 계층의 AGENTS.md를 제공한다 — Codex가 자연어 요청을 해석하고 적절한 슬래시 커맨드로 라우팅하도록 돕는다.

파일	위치	용도
저장소 루트	`../AGENTS.md`	plugin-mh 자체를 Codex로 개발할 때의 컨벤션·동기화 규칙·금지 사항
카탈로그	`./AGENTS.md`	14개 슬래시 커맨드 카탈로그 + 자연어 트리거 매핑
배포 템플릿	`./template/AGENTS.md`	다른 프로젝트에 가져갈 워크플로우 템플릿 (Spec→Build→Verify→Ship 패턴)
개인 글로벌	`./user-global-AGENTS.md`	`~/.codex/AGENTS.md` 로 복사하면 모든 프로젝트에서 자동 활성
가드레일	`../guardrails/README.md`	언어별 선호와 법칙 기반 작업 제약

적용 방법

# 1. 저장소 루트 AGENTS.md — Codex가 plugin-mh 작업 디렉토리에서 자동 로드 (별도 작업 불필요)

# 2. 다른 프로젝트에 워크플로우 적용
cp codex/template/AGENTS.md ~/my-project/AGENTS.md
# 또는 자기 AGENTS.md에 흡수

# 3. 개인 글로벌 가이드 (모든 프로젝트에서 활성화)
cp codex/user-global-AGENTS.md ~/.codex/AGENTS.md     # macOS / Linux
Copy-Item codex/user-global-AGENTS.md $env:USERPROFILE\.codex\AGENTS.md   # Windows PowerShell

변환 규칙 (원본 SKILL.md → Codex 프롬프트)

원본 (Claude)	변환 후 (Codex)
YAML frontmatter (`name`, `description`, `version` 등)	제거하고 헤더 형식 한 줄 요약으로
`AskUserQuestion` 도구	"사용자에게 다음 질문을 제시하고 번호로 답하게 하세요" + 번호 옵션
`Agent(subagent_type=...)`	"이 단계에서는 {역할}처럼 사고하세요" + 자연어 작업 분해
`Skill(skill="plugin-mh:grill-me")`	`/grill-me` 슬래시 커맨드
`mcp__plugin_playwright_*`	"Playwright MCP를 통해" 일반 표현
Read/Glob/Grep/Bash/Write/Edit	그대로 유지 (Codex도 동등 도구 보유)

워크플로우 / 프로토콜 / 출력 형식 / 안티패턴 / 예시는 그대로 보존된다.

references/ 파일

일부 프롬프트는 references/... 파일을 언급한다. 이 파일들은 plugin-mh 저장소의 skills/<skill-name>/references/ 에 위치한다. Codex가 필요할 때 직접 Read 하면 된다.

제거 (Uninstall)

Codex plugin 설치본 제거:

codex plugin remove plugin-mh@plugin-mh

legacy adapter 제거:

# Windows
Get-ChildItem $env:USERPROFILE\.codex\prompts\ | Where-Object { $_.Name -in (Get-ChildItem .\codex\prompts\ -Filter *.md | Select-Object -ExpandProperty Name) } | Remove-Item
Get-ChildItem $env:USERPROFILE\.codex\skills\ | Where-Object { $_.Name -in (Get-ChildItem .\skills\ -Directory | Select-Object -ExpandProperty Name) } | Remove-Item

# macOS / Linux
for f in codex/prompts/*.md; do
  rm -f "$HOME/.codex/prompts/$(basename "$f")"
done
for d in skills/*; do
  rm -rf "$HOME/.codex/skills/$(basename "$d")"
done

동기화 (원본 변경 시)

skills/<name>/SKILL.md 를 수정한 뒤 codex/prompts/<name>.md 도 같은 변환 규칙으로 갱신하면 된다. 원본과 변환본이 갈라지지 않도록 주의.

라이선스

원본 plugin-mh와 동일 (MIT).

FilesExpand file tree

codex

Directory actions

More options