skills-sync

Align Codex-native skills with documented skills safely.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 30, 2025

When & Why to Use This Skill

The skills_sync skill is a specialized utility designed to maintain perfect alignment between Codex-native agent capabilities and their official documentation. By automating the synchronization of the .codex/skills/ and .agent-docs/skills/ directories, it eliminates documentation drift, validates metadata integrity, and ensures that the agent's skill registry is always up-to-date and accurately reflected in status reports.

Use Cases

  • Automated Documentation Sync: Automatically detect and bridge gaps between implemented agent skills and their documented counterparts to ensure developers always have access to current information.
  • Standardized Skill Validation: Enforce naming conventions and frontmatter requirements across all skill folders to maintain a clean and predictable agent architecture.
  • Safe Content Merging: Integrate new skill entries into the documentation index using a merge protocol that protects existing content from accidental overwrites.
  • Project Status Tracking: Keep the SKILLS_STATUS.md file updated in real-time, providing a clear overview of the agent's current capabilities and development progress.
nameskills_sync
descriptionAlign Codex-native skills with documented skills safely.
short-descriptionSkills sync

Purpose

Ensure .codex/skills/ matches .agent-docs/skills/.

Steps

  1. Check for missing skills in either location.
  2. Update index.md to list new skills.
  3. Add missing entries using merge protocol.
  4. Validate frontmatter and folder naming.
  5. Update .agent-docs/memory/SKILLS_STATUS.md.

Guardrails

  • Avoid overwriting existing skill content.