oozoofrog 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