agents-md-manager
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).
npx skills add majiayu000/claude-skill-registry --skill agents-md-manager --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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: ```bash python3 ~/.claude/skills/agents-md-manager/scripts/analyze_project.py [project_path] ``` Output: JSON report with tech stack, commands, directory structure, and Codex artifact inventory (AGENTS.md, config.toml, .rules, .agents/skills/, CLAUDE.md conversion candidates). ## 2. AGENTS.md Generation Apply the WHAT/WHY/HOW framework in **plain markdown only**—no `@import` syntax, no YAML frontmatter. ### Recommended Sections ```markdown # Proje
- Core Workflow
- 1. Project Analysis
- 2. AGENTS.md Generation
- Recommended Sections
- Constraints
- 3. CLAUDE.md Conversion
- 4. Config Generation
- 5. Rules Files
- 6. Codex Skills
- 7. Audit Checklist
- 8. Nested AGENTS.md (Monorepos)
- Integration Notes
- Reference Documentation
python3 ~/.claude/skills/agents-md-manager/scripts/analyze_project.py [project_path] python3 ~/.claude/skills/agents-md-manager/scripts/convert_claude_to_agents.py <claude_md_path> [output_path] python3 ~/.claude/skills/agents-md-manager/scripts/generate_config_toml.py [--global | --project <path>] [--model MODEL] [--sandbox MODE] python3 ~/.claude/skills/agents-md-manager/scripts/scaffold_codex_skill.py <name> [--path <dir>] python3 ~/.claude/skills/agents-md-manager/scripts/validate_agents_md.py [project_path]
What does the agents-md-manager skill do?
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).
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill agents-md-manager --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.
