skills-sync
Align Codex-native skills with documented skills safely.
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.
| name | skills_sync |
|---|---|
| description | Align Codex-native skills with documented skills safely. |
| short-description | Skills sync |
Purpose
Ensure .codex/skills/ matches .agent-docs/skills/.
Steps
- Check for missing skills in either location.
- Update
index.mdto list new skills. - Add missing entries using merge protocol.
- Validate frontmatter and folder naming.
- Update
.agent-docs/memory/SKILLS_STATUS.md.
Guardrails
- Avoid overwriting existing skill content.