agents-md-manager

name

agents-md-manager

description

This skill should be used when creating, auditing, or maintaining AGENTS.md files and Codex CLI configuration for any project—including initializing AGENTS.md for cross-agent compatibility (Codex, Cursor, Copilot, Devin, Jules, Amp, Gemini CLI), generating config.toml or .rules files, scaffolding .agents/skills/, converting CLAUDE.md to AGENTS.md, or auditing existing agent configs for bloat and staleness. Complementary to codex-orchestrator (which executes subagents; this skill creates the config files they consume).

AGENTS.md Manager

Create and maintain AGENTS.md files and Codex CLI configuration for any project.

Core Workflow

Determine the mode:

Mode	When	Script
Create	New project needs AGENTS.md	scripts/analyze_project.py then write
Refresh	Existing AGENTS.md needs audit	scripts/validate_agents_md.py
Convert	Migrate from CLAUDE.md	scripts/convert_claude_to_agents.py
Config	Generate config.toml	scripts/generate_config_toml.py
Rules	Create .rules files	See references/starlark-rules-spec.md
Skills	Scaffold .agents/skills/	scripts/scaffold_codex_skill.py

1. Project Analysis

Run analysis to detect stack, existing config, and gaps:

python3 ~/.claude/skills/agents-md-manager/scripts/analyze_project.py [project_path]