| name | sync-skills |
| description | Synchronize AI agent skills and build binaries from the dotfiles repository. |
Sync Skills
This skill allows the agent to refresh the AI agent environment by synchronizing skills from the dotfiles repository to the system and optionally rebuilding core binaries.
Usage
Always run sync-skills using the established alias, which points to the version in ~/opt/scripts/system/sync-skills.sh.
Using the ~/opt path ensures that you are running the scripts as they are installed in the user's environment, maintaining consistency across different machines and installations.
1. Synchronize Skills
Link all available skills into both ~/.gemini/config/skills (Antigravity CLI) and ~/.claude/skills (Claude Code). The single discovery pass keeps both assistants in sync from one source of truth.
bash ~/opt/scripts/system/sync-skills.sh
Or via alias if available:
sync-skills
2. Synchronize and Build
Link skills and rebuild core binaries (gss, tmux-mgr, wol).
bash ~/opt/scripts/system/sync-skills.sh --build
Mandatory Reload
After running sync-skills, the agent MUST inform the user that they need to manually reload their session for the newly-linked skills to be discovered:
- Antigravity CLI (
agy): Restart the session (skills are scanned from ~/.gemini/config/skills at startup).
- Claude Code: Restart Claude Code (skills are scanned from
~/.claude/skills at startup; a running session will not see new links until relaunched).