| name | plugin-doctor |
| description | Codex 플러그인/스킬 저장소를 감사하고 개선합니다. `.codex-plugin/plugin.json`, `.agents/plugins/marketplace.json`, `.agents/skills`, `.codex/agents`, legacy Claude 산출물을 점검할 때 사용합니다. |
Plugin Doctor
원본 fixer 스킬을 Codex 기준으로 옮긴 버전입니다.
When to use
- Codex 플러그인/스킬 저장소의 packaging 구조를 감사하고 개선할 때
.codex-plugin/plugin.json, marketplace manifest, custom agents, legacy Claude 흔적을 점검할 때- repo-local skill과 optional plugin 배포 레이어의 정합성을 함께 봐야 할 때
Do not use when
- 개별 skill authoring/discovery 개선이 주목적인 작업 →
codex-skill-audit, codex-skill-bootstrap
AGENTS.md 계층 설계·검증이 주목적인 작업 → agent-context-*- 일반 코드 구현/리팩터링만 필요한 작업
Quick start
- 감사 대상 루트를 정하고 plugin audit script를 먼저 실행한다.
- legacy Claude residue와 manifest 정합성을 수동 점검한다.
critical / warning / info / strength와 안전한 자동 수정 후보를 분리한다.
Use resources
references/official-spec.mdscripts/audit_codex_plugin_repo.pyschemas/report.schema.json../../../docs/evaluator-output-contract.md- 필요 시 현재 저장소에 별도로 있는
codex-skill-audit 또는 동등한 skill audit 도구를 함께 사용
Workflow
- 감사 대상 루트를 결정한다. 기본값은 현재 저장소다.
scripts/audit_codex_plugin_repo.py [target]로 결정적 구조 감사를 먼저 수행한다.- legacy Claude 산출물(
CLAUDE.md, .claude-plugin/, hooks 전용 구조`)이 남아 있는지 확인한다.
- repo-local skills, optional plugin packaging, custom agents의 정합성을 수동 점검한다.
critical / warning / info / strength로 결과를 보고하고, 안전한 자동 수정 후보를 분리한다.
What this skill focuses on
.agents/skills/**/SKILL.md- optional
agents/openai.yaml
.codex/agents/*.toml.agents/plugins/marketplace.json와 plugins/*/.codex-plugin/plugin.json (존재하는 경우).mcp.json, .app.json 같은 보조 매니페스트- Codex로 옮기면서 남은 Claude 전용 흔적
Review Harness
- mode: none
- 공통 기준:
../../../docs/review-harness.md
- generator: 상위 변경사항 또는 감사 대상 repo 구조
- evaluator: 이 스킬 자체와 audit script가 evaluator-native plugin audit 역할을 수행한다
- 평가축: marketplace↔package 정합성, manifest 품질, legacy residue, custom agent/skill 연결성
- artifacts/evidence: manifest 구조, audit script output, legacy residue, custom agent 정합성
- pass condition: plugin/skill/custom agent 레이어의 구조 문제를 severity와 근거와 함께 설명할 수 있어야 한다
- 자동 다음 행동:
pass면 종료, warning이면 metadata 정리, critical이면 packaging 또는 manifest를 재생성하고 필요 시 sync_packaged_plugins.py를 재실행한다
Output expectation
- 감사 범위
critical / warning / info / strength 결과- 안전한 자동 수정 후보
- 사람이 직접 판단해야 할 packaging 리스크
deterministic audit script는 아래 artifact를 함께 지원하는 편을 권장합니다.
- stdout: 사람이 읽는 Markdown 보고서
--json-out <path>: schemas/report.schema.json에 맞는 machine summary JSON
