sync-skills git:20260524.8acd1e3A

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

---
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** `~/.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 newly-linked skills to be discovered:

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