# Codex Md Improver > Audit and optimize AGENTS.md for Codex projects, with optional cross-check against CLAUDE.md if present. Use when user asks to improve agent instructions, remove stale guidance, align workflow docs with real tooling, or harden operational guardrails. Use when this capability is needed. - Skill: `tomevault-io/codex-md-improver-2` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/codex-md-improver-2` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/codex-md-improver-2/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/codex-md-improver-2 --- # Codex MD Improver Prioritize `AGENTS.md` as the source of truth for Codex behavior. Treat `CLAUDE.md` as optional context only. Do not import Claude Code plugin workflows into Codex instructions. ## Workflow 1. Discover instruction files: `AGENTS.md`, optional `CLAUDE.md`, related workflow docs. 2. Build a contradiction map: conflicting rules, duplicate guidance, stale commands. 3. Normalize around Codex execution model: - shell-driven automation - repository checks (lint/test/CI) - explicit approval and safety boundaries 4. Rewrite `AGENTS.md` to be concise, testable, and command-oriented. 5. Preserve useful knowledge from `CLAUDE.md` only when tool-agnostic. 6. Output a change summary with risks and follow-up actions. ## Acceptance Criteria - `AGENTS.md` has clear priorities and no conflicting rules. - Commands/paths are current and executable. - Safety-critical actions have explicit guardrails. - No Claude-only runtime assumptions. --- > Source: [rldyourmnd/codex-cli-bootstrap](https://github.com/rldyourmnd/codex-cli-bootstrap) — distributed by [TomeVault](https://tomevault.io).