alirezarezvani

/sync-agents-md - Regenerate AGENTS.md from CLAUDE.md

Development community intermediate

SOURCE https://github.com/alirezarezvani/claude-code-skill-factory

Description

**Synchronize AGENTS.md with current CLAUDE.md using the codex-cli-bridge skill.** ---

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

Repository README

This is the README for alirezarezvani/claude-code-skill-factory, shared by 13 entries in this directory. It describes the repository, not this entry specifically.

/sync-agents-md - Regenerate AGENTS.md from CLAUDE.md

**Synchronize AGENTS.md with current CLAUDE.md using the codex-cli-bridge skill.**

Usage

/sync-agents-md
/sync-agents-md --validate
/sync-agents-md --status

What This Command Does

**Default** (`/sync-agents-md`):

Runs the codex-cli-bridge skill
Validates environment (Codex CLI + CLAUDE.md)
Parses CLAUDE.md and project structure
Regenerates AGENTS.md with latest changes
Overwrites existing AGENTS.md

**With `--validate`**:

Validates environment only (no regeneration)
Checks Codex CLI installation
Checks CLAUDE.md exists
Shows status report

**With `--status`**:

Shows current sync status
Displays when AGENTS.md was last updated
Lists documented skills and agents

When to Use

**Run this command when**:

✅ CLAUDE.md has been updated
✅ New skills added to .claude/skills/
✅ New agents added to .claude/agents/
✅ Project structure changed
✅ AGENTS.md is out of sync
✅ Team needs latest Codex CLI documentation

**Don't need to run when**:

❌ Only code changes (no config changes)
❌ AGENTS.md already current
❌ Working only with Claude Code (not Codex CLI)

How It Works

Step 1: Environment Validation

🔍 Checking Codex CLI installation...
   ✅ Found: /path/to/codex
   Version: codex-cli 0.50.0

📄 Checking CLAUDE.md...
   ✅ Found: /project/CLAUDE.md

✅ All safety checks passed!

Step 2: Project Analysis

📖 Parsing Claude Code project...
   ✅ Found 13 skills
   ✅ Found 59 agents
   ✅ Found 58 CLAUDE.md sections

📊 Project: your-project
📁 Type: GREENFIELD_NEW

Step 3: AGENTS.md Generation

📝 Generating AGENTS.md...
   ✅ AGENTS.md generated successfully

📄 Output: /project/AGENTS.md
📊 Skills documented: 13
🤖 Agents documented: 59

Examples

Example 1: Basic Sync

**User**:

/sync-agents-md

**What happens**:

Validates Codex CLI installed
Checks CLAUDE.md exists
Parses project structure
Regenerates AGENTS.md
Success message with statistics

**Output**:

✅ SUCCESS - AGENTS.MD REGENERATED

📄 Output: AGENTS.md
📊 Skills documented: 13
🤖 Agents documented: 59

AGENTS.md is now in sync with CLAUDE.md

Example 2: Validate Only

**User**:

/sync-agents-md --validate

**What happens**:

Checks Codex CLI installation
Checks CLAUDE.md exists
Shows status report
Does NOT regenerate AGENTS.md

**Output**:

✅ VALIDATION PASSED

Environment is ready for AGENTS.md generation.

Codex CLI: v0.50.0 ✅
CLAUDE.md: Found ✅
AGENTS.md: Exists (last updated: 2025-10-30)

To regenerate: /sync-agents-md

Example 3: Status Check

**User**:

/sync-agents-md --status

**What happens**: Shows current project status

**Output**:

📊 SYNC STATUS

Project: claude-code-skills-factory
CLAUDE.md: ✅ Exists
AGENTS.md: ✅ Exists (in sync)
Last updated: 2025-10-30 15:52

Skills: 13 (8 functional, 5 prompt-based)
Agents