What is the primary purpose of the Skills Sync skill?

It ensures that the functional skills in your .codex directory stay synchronized with the descriptive documentation in your .agent-docs folder.

Will this skill overwrite my existing code?

No, the skill includes specific guardrails and uses a merge protocol designed to avoid overwriting existing content or logic.

How does it track the status of my skills?

It automatically updates a central SKILLS_STATUS.md file within your agent's memory to provide a high-level overview of synchronization state.

Does it handle metadata validation?

Yes, it specifically checks and validates frontmatter and folder naming to ensure your skill library remains standardized and searchable.

Codex Skills Sync

Name: Codex Skills Sync
Author: CheekyCodexConjurer

byCheekyCodexConjurer

0•

Content Management

Synchronizes and validates skill definitions between local directories to ensure documentation and functionality remain perfectly aligned.

Codex Skills Sync is a specialized maintenance utility designed to bridge the gap between active functional skills and their documentation. It automatically audits the .codex/skills/ and .agent-docs/skills/ directories to identify discrepancies, updates central index files, and validates metadata frontmatter for consistency. By implementing a safe merge protocol, it ensures that new capabilities are registered without risking the integrity of existing content, making it an essential tool for developers managing complex, local-first agentic environments.

Key Features

01Automated index.md updates to maintain an accurate list of available capabilities.

020 GitHub stars

03Bi-directional synchronization between functional skill folders and documentation directories.

04Strict validation for frontmatter metadata and folder naming conventions.

05Safe merge protocol to prevent accidental overwriting of existing skill logic.

06Automatic status tracking updates for the SKILLS_STATUS.md memory file.

Use Cases

01Maintaining a consistent source of truth for AI agent capabilities in quantitative research workstations.

02Auditing local repositories to ensure every functional skill has matching documentation.

03Automating the registration and indexing of new Claude Code skills.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cheekycodexconjurer/quant-lab skills_sync

For use in Claude.ai and ChatGPT

Download Skill