Sync Agent Instructions

SkillFiles & storage

Sync AI coding tool instruction files (AGENTS.md, GEMINI.md, AGENTS.md) so they stay aligned. Detects which file changed and copies it to the others. Use when syncing md files, syncing instructions, updating GEMINI.md, or updating AGENTS.md.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Sync Agent Instructions skill

What this skill tells your AI

The instructions your AI receives, as published by reflexioai/reflexio in .agents/skills/sync-agent-instructions/SKILL.md and read by ahel’s review.

Keep AGENTS.md, GEMINI.md, and AGENTS.md in sync so all AI coding tools share the same project instructions.

Workflow

  1. Detect changes — Run git diff HEAD -- AGENTS.md GEMINI.md AGENTS.md to see which file(s) have uncommitted changes.

  2. Determine source file:

    • One file changed — That file is the source. Copy its content to the other two.
    • Multiple files changed — Ask the user which file to use as the source.
    • No files changed — Compare all three with diff. If they differ, report which sections differ and ask the user which file to use as source. If identical, report "All instruction files are in sync." and stop.
  3. Sync — Read the source file and write its exact content to the other two files.

  4. Stage — Run git add on the two modified files.

  5. Report — Tell the user which file was the source and that the other two have been updated.

Signals

GitHub stars
367
Forks
48
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
sync-agent-instructions-reflexioai
Source
github.com/reflexioai/reflexio