Sync Agent Instructions
Keeps CLAUDE.md, GEMINI.md and AGENTS.md identical by copying the changed one to the others
Test report
- Verdict
- Tested · Works
- Score
- Tested
- Jul 21, 2026
- Environment
- Claude Code 2.x (agent harness)
- Upstream re-checked
- Aug 10, 2026 · 98a9d4e
Fetched SKILL.md via raw GitHub; frontmatter parses with name+description and the body references only the user's own CLAUDE.md/GEMINI.md/AGENTS.md plus git diff/cp/git add, so no external files to spot-check and no security smells. I built a temp git repo where CLAUDE.md was edited and the other two were stale, then ran a baseline (naive cp of all three, no git logic) against the skill's workflow strictly. Both propagated content identically, but the observed difference is staging: the skill's git-diff source-detection plus git add left GEMINI.md and AGENTS.md staged (git status "M ") while the baseline left all three unstaged (" M"), and the skill leaves the source CLAUDE.md unstaged. Trigger phrasings tested — YES: "I updated CLAUDE.md, sync it to GEMINI.md and AGENTS.md", "keep my agent instruction files in sync", "update AGENTS.md to match my Claude instructions"; NO: "sync my forked repo with upstream", "update the README.md with install steps".
Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works
- Installs cleanly 5/5
- Triggers reliably 5/5
- Output vs. baseline 6/10
- Docs & honesty 5/5
What Sync Agent Instructions does
Detects which of CLAUDE.md, GEMINI.md, or AGENTS.md has uncommitted changes via git diff, then overwrites the other two with the changed file's exact content and stages them. Triggers when the user asks to sync instruction files, update GEMINI.md/AGENTS.md, or keep AI coding tool instructions aligned. It is a pure git+filesystem workflow with no external dependencies.
How to install Sync Agent Instructions
git clone --depth 1 https://github.com/ReflexioAI/claude-smart.git /tmp/sync-agent-instructions-src
mkdir -p ~/.claude/skills
cp -R /tmp/sync-agent-instructions-src/.claude/skills/sync-agent-instructions ~/.claude/skills/sync-agent-instructions
# No external deps: the skill is a plain workflow using git diff, cp, and git add.
# An identical copy also lives at .agents/skills/sync-agent-instructions/ for non-Claude tools.
Skills live in ~/.claude/skills/ (global) or .claude/skills/
(per-project). Restart Claude Code after installing.
Commands — how to trigger Sync Agent Instructions
-
/sync-agent-instructionsKeeps CLAUDE.md, GEMINI.md and AGENTS.md identical by copying the changed one to the others
It also activates on plain-language prompts like these:
-
Sync my updated CLAUDE.md to GEMINI.md and AGENTS.md -
Detect which instruction file changed and propagate it -
Update AGENTS.md to match the latest CLAUDE.md
Frequently asked questions
- Is the Sync Agent Instructions skill free?
- Yes. The skill itself is free from ReflexioAI/claude-smart. SkillProof publishes the install command and an independent test verdict at no cost.
- Does Sync Agent Instructions work with Claude Code?
- We tested it with Claude Code 2.x (agent harness) on Jul 21, 2026. Verdict: Tested · Works. Fetched SKILL.md via raw GitHub; frontmatter parses with name+description and the body references only the user's own CLAUDE.md/GEMINI.md/AGENTS.md plus git diff/cp/git add, so no external files to spot-check and no security smells. I built a temp git repo where CLAUDE.md was edited and the other two were stale, then ran a baseline (naive cp of all three, no git logic) against the skill's workflow strictly. Both propagated content identically, but the observed difference is staging: the skill's git-diff source-detection plus git add left GEMINI.md and AGENTS.md staged (git status "M ") while the baseline left all three unstaged (" M"), and the skill leaves the source CLAUDE.md unstaged. Trigger phrasings tested — YES: "I updated CLAUDE.md, sync it to GEMINI.md and AGENTS.md", "keep my agent instruction files in sync", "update AGENTS.md to match my Claude instructions"; NO: "sync my forked repo with upstream", "update the README.md with install steps".
- What is the Sync Agent Instructions SkillProof Score?
- 8.4/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 6/10, docs & honesty 5/5.
- How do I install Sync Agent Instructions?
- Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
- Can I use Sync Agent Instructions with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
- The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.