sync-skills

Instructions

IMPORTANT

Only use this skill in /usr/local/hal-9000 . Otherwise, abort. 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 Update README.md (the

Agent 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 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()" 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) Update dotfiles/hal_dotfiles.json (the links array) Format: {"dest": "{{HOME}}/.claude/skills//", "src": "{{REPO_ROOT}}/skills//"} 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 Run ./bin/hal sync , then report what changed.