skills.rest
owebboy
owebboyCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

agents-md-sync

Parse CLAUDE.md files and generate AGENTS.md for OpenAI Codex compatibility.

1|Updated Apr 3, 2026
Search Tags:#automation#workflow#documentation#codex#claude#sync
One-click install
npx skills add https://github.com/owebboy/maestro --skill agents-md-sync-owebboy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agents-md-sync
Source: https://github.com/owebboy/maestro/tree/main/skills/agents-md-sync
Command: npx skills add https://github.com/owebboy/maestro --skill agents-md-sync-owebboy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the fragmentation of project documentation when working in multi-agent environments, specifically ensuring that instructions defined in CLAUDE.md are correctly translated and available for OpenAI Codex via AGENTS.md.

Core Features & Use Cases

  • Automated Synchronization: Automatically extracts coding conventions, build commands, and architecture invariants from CLAUDE.md.
  • Format Translation: Converts Claude-specific syntax and hooks into Codex-compatible TOML and Markdown structures.
  • Use Case: When a developer updates the project-wide coding standards in CLAUDE.md, this skill ensures those changes are reflected in AGENTS.md so the Codex agent remains perfectly aligned with the project's current requirements.

Quick Start

Run the agents-md-sync skill to update your AGENTS.md file based on the latest changes in your project CLAUDE.md file.

Frequently Asked Questions about agents-md-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync project guidance between Claude and Codex?▼

To sync project guidance between Claude and Codex, this Skill parses CLAUDE.md files and automatically generates or updates AGENTS.md, translating Claude-specific syntax and hooks into Codex-compatible TOML and Markdown structures.

What is the best way to keep AGENTS.md updated with CLAUDE.md changes?▼

The best way to keep AGENTS.md updated is by running an automated synchronization process that extracts coding conventions, build commands, and architecture invariants from CLAUDE.md and maps them into a unified, tool-neutral documentation format for Codex.

Can I sync coding standards across project subdirectories for OpenAI Codex?▼

Yes, you can sync coding standards across project roots and subdirectories. The synchronization logic operates across the entire project structure to ensure consistent development workflows and coding standards for Codex.

Does translating CLAUDE.md to AGENTS.md convert Claude hooks into Codex-compatible formats?▼

Yes, translating CLAUDE.md to AGENTS.md converts Claude-specific configurations, hooks, and conventions into Codex-compatible TOML and Markdown structures, ensuring the Codex agent aligns with current project requirements.

Why does my Codex agent ignore project-wide coding standards defined in CLAUDE.md?▼

Your Codex agent ignores CLAUDE.md standards because it requires an AGENTS.md file. Synchronizing your project guidance translates the coding standards into the Codex-compatible format needed for the agent to recognize and apply them.

Related Skills

Explore More Software Engineering Skills→
fyrsmithlabsfyrsmithlabs

setup

Analyze a repository and generate CLAUDE.md with governance and onboarding guidance.

Official
Advanced
kid-sidkid-sid
18

codex-orchestration

Diagnose OpenAI Codex CLI orchestration misconfigurations and debugging challenges.

Community
Intermediate
mikkeymoomikkeymoo
1

mm-docs

Generate and update documentation for files, modules, and APIs using OpenAPI standards.

Community
Advanced
mori-shin-xmori-shin-x
12

speckit-agent-context-update

Synchronize project documentation and plan paths in coding agent instruction files.

Community
Intermediate