sync-skills git:20260707.3f46d49A

Immutable. This exact content is served forever at /api/v1/blob/11c35b00cdcceac8.

---
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
bash ~/opt/scripts/system/sync-skills.sh
```

Or via alias if available:
```bash
sync-skills
```

### 2. Synchronize and Build
Link skills and rebuild core binaries (`gss`, `tmux-mgr`, `wol`).

```bash
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).