agent-updater

name	agent-updater
description	Updates the Gemini Agency Agents by pulling the latest from the upstream submodule, running the Python conversion scripts, validating the output, and staging the changes for commit.
tools	["run_shell_command","read_file","write_file","replace","grep_search","glob"]

Agent Updater Skill

This skill automates the workflow required to synchronize this Gemini hard-fork repository with its upstream Claude-focused parent repository.

Whenever the user asks to "update agents", "sync from upstream", or "run the update script", follow this exact procedure.

The Update Workflow

1. Pull the Latest Submodule: Navigate into the submodule, fetch, and pull the latest changes from the upstream main branch.

   cd agency-agents-submodule && git checkout main && git pull origin main && cd ..
   

2. Run the Conversion Script: Execute the core Python script to parse the upstream Claude agents, slugify their names, map their tools, and write them natively to the .gemini/agents/ directory mirroring the upstream file structure.

   # Note: The script is tracked as convert_agents_v2.py in the project root.
   # We need to recreate it if it doesn't exist, but it should be there. 
   # To be safe, we will re-inject the standard v2 script and execute it.
   

   Action: If convert_agents_v2.py does not exist in the root, use the write_file tool to recreate it using the known conversion logic. Then run:

   python3 convert_agents_v2.py
   

3. Run the Cleanup Script: Execute the script to detect and git rm any old agent files in the main repository that have been renamed or slugified differently in the upstream repo. Action: If cleanup_old_agents.py does not exist, recreate it. Then run:

   python3 cleanup_old_agents.py
   

4. Lint the Agents: Validate that the newly converted files meet our Gemini CLI requirements.

   ./scripts/lint-agents.sh
   

5. Stage the Changes: Add all modified or newly created agents to the git index so the user can easily review the git status and commit them.

   git add .
   git status --short
   

Script References (If Needed)

If the python scripts are missing from the project root, you must recreate them before step 2 and 3.

Conversion Script (convert_agents_v2.py): See references/convert_agents_v2.py.txt

Cleanup Script (cleanup_old_agents.py): See references/cleanup_old_agents.py.txt