git:20260524.bf03695 to git:20260524.8acd1e3

3 added, 3 removed. Audit A to A.

---

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 `~/.agents/skills`.

+ Link all available skills into **both** `~/.agents/skills` (Gemini 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 changes to take effect:

+ 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:

- **Gemini CLI**: Run `/skills reload`

- - **Claude Code**: Refresh the session or restart the agent.

+ - **Claude Code**: Restart Claude Code (skills are scanned from `~/.claude/skills` at startup; a running session will not see new links until relaunched).