skills.rest
jmagar
jmagarCOMMUNITY
Explore all skills by this author →
GitHub

sync-claude-mds

Create and refresh AGENTS.md and GEMINI.md symlinks for CLAUDE.md files.

Updated Aug 23, 2026
Search Tags:#sync#symlinks#claude-md#repo-management#agents-md#gemini-md
One-click install
npx skills add https://github.com/jmagar/rust-bin --skill sync-claude-mds
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sync-claude-mds
Source: https://github.com/jmagar/rust-bin/tree/main/.claude/skills/sync-claude-mds
Command: npx skills add https://github.com/jmagar/rust-bin --skill sync-claude-mds

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

CLAUDE.md is the canonical agent instruction file; this skill keeps AGENTS.md and GEMINI.md symlinks in lockstep so Codex and Gemini see the same instructions, even in nested repository layouts, avoiding stale or missing agent context.

Core Features & Use Cases

  • Discover CLAUDE.md files across the repository (including nested ones) and identify missing or stale AGENTS.md and GEMINI.md siblings.
  • Create or refresh symlinks beside CLAUDE.md pointing to CLAUDE.md, while refusing to overwrite existing real files to prevent data loss.
  • Operate idempotently and provide a clear summary of actions and blocked instances for safe, repeatable runs.

Quick Start

Run the script to synchronize CLAUDE.md with AGENTS.md and GEMINI.md across the repository.

Frequently Asked Questions about sync-claude-mds

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

FAQPage Schema
How do I sync CLAUDE.md with AGENTS.md and GEMINI.md in a repository?▼

To sync CLAUDE.md, the script walks the repository and creates symlinks for AGENTS.md and GEMINI.md, ensuring consistent agent instructions across nested layouts.

How do symlinks keep AGENTS.md and GEMINI.md updated with CLAUDE.md?▼

Symlinks ensure AGENTS.md and GEMINI.md point directly to CLAUDE.md, so any instruction changes automatically reflect across all agent files without manual duplication.

Does syncing AGENTS.md and GEMINI.md overwrite existing real files?▼

No, syncing AGENTS.md and GEMINI.md refuses to overwrite existing real files, guarding your data by only creating or refreshing symlinks while reporting blocked instances.

Can I sync CLAUDE.md instructions across nested repository directories?▼

Yes, you can sync CLAUDE.md across nested directories; the script discovers nested files and creates matching AGENTS.md and GEMINI.md siblings for every CLAUDE.md found.

What is the best way to automate agent instruction file management for Codex and Gemini?▼

Automating agent instruction management is best done with a self-contained Bash script that operates idempotently, safely refreshing symlinks and reporting actions for repeatable runs.

Related Skills

Explore More Software Engineering Skills→
sblueminsbluemin
16

sync-agents-symlinks

Create CLAUDE.md symlinks for directories containing AGENTS.md files.

Community
Basic
PeterFilePeterFile
4

multi-agent-orchestration

Orchestrate multi-agent workflows from Kiro specs using Codex and Gemini.

Community
Advanced
dewittdewitt

dx-toolchain

Lint, format, and diff Markdown system declarations with a Go-based CLI.

Community
Advanced
martylouismartylouis

agents-md

Migrate CLAUDE.md files to AGENTS.md with symlinks and status checks.

Community
Intermediate