---
name: sync-skills
description: (hal-9000) Use when a skill in skills/ has its name or description changed, or is added or removed — syncs README.md, CLAUDE.md, settings.json, and hal_dotfiles.json
context: fork
user-invocable: true
model: haiku
allowed-tools:
  - Glob
  - Read
  - Edit
  - Bash(./bin/hal sync:*)
---

# Instructions

**IMPORTANT**: Only use this skill in `/usr/local/hal-9000`. Otherwise, abort.

1. **Discover skills**
   - Glob `skills/*/SKILL.md` in `/usr/local/hal-9000` only
   - Extract `name` from each YAML frontmatter
   - Rewrite each `description` into one short sentence (~10 words max) saying what it does — no "Use when" triggers, no verbatim frontmatter copy

2. **Update `README.md`** (the `### Agent Skills` section)
   - Format: `- [name](skills/name): description`
   - Use the rewritten description from step 1
   - Add new skills, remove deleted skills, update changed descriptions
   - Preserve existing entry order; append new entries at end

3. **Update `dotfiles/.claude/CLAUDE.md`** (the `## Skills` section)
   - Format: `- \`name\`: description`
   - Use the rewritten description from step 1
   - Add new skills, remove deleted skills, update changed descriptions
   - Preserve existing entry order; append new entries at end

4. **Update `dotfiles/.claude/settings.json`** (the `permissions.allow` array)
   - Sync the `Skill(...)` entries to match discovered user-invocable skills
   - Only include skills with `user-invocable: true` in frontmatter
   - Format: `"Skill(<name>)"`
   - Add new skills, remove entries whose skill no longer exists
   - Preserve existing entry order; append new entries at end
   - Keep the entries in the same position block (between other tool entries)

5. **Update `dotfiles/hal_dotfiles.json`** (the `links` array)
   - Format: `{"dest": "{{HOME}}/.claude/skills/<name>/", "src": "{{REPO_ROOT}}/skills/<name>/"}`
   - Add new skill dirs, remove entries whose `"src"` matches `{{REPO_ROOT}}/skills/*` but no longer has a matching skill
   - Preserve existing entry order; append new entries at end
   - Leave non-skill entries and `copies` array as-is

6. **Run `./bin/hal sync`**, then report what changed.