Plugin Doctor

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

1. 감사 대상 루트를 정하고 plugin audit script를 먼저 실행한다.
2. legacy Claude residue와 manifest 정합성을 수동 점검한다.
3. critical / warning / info / strength와 안전한 자동 수정 후보를 분리한다.

Use resources

• references/official-spec.md
• scripts/audit_codex_plugin_repo.py
• schemas/report.schema.json
• ../../../docs/evaluator-output-contract.md
• 필요 시 ../codex-skill-audit/scripts/audit_codex_skill_repo.py

Workflow

1. 감사 대상 루트를 결정한다. 기본값은 현재 저장소다.
2. scripts/audit_codex_plugin_repo.py [target]로 결정적 구조 감사를 먼저 수행한다.
3. legacy Claude 산출물(CLAUDE.md, .claude-plugin/, hooks 전용 구조`)이 남아 있는지 확인한다.
4. repo-local skills, optional plugin packaging, custom agents의 정합성을 수동 점검한다.
5. 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