Overview

dotfiles/.claude/skills/

• dotfiles/.claude/CLAUDE.md

  -- the

  ## Skills

  section

• dotfiles/hal_dotfiles.json

  -- the

  copies

  entries for skill directories

hal sync

Instructions

1. Find the project root: Use Glob to locate

   dotfiles/.claude/skills/*/SKILL.md

   . The project root is the repo containing

   dotfiles/

   .
2. Read each SKILL.md frontmatter: For every skill found, extract

   name

   and

   description

   from the YAML frontmatter.
3. Update

   dotfiles/.claude/CLAUDE.md

   :
   • Find the

     ## Skills

     section (starts with

     ## Skills

     heading).
   • Replace everything from

     ## Skills

     up to the next

     ##

     heading (or end of file) with a regenerated list.
   • Include all discovered skills.
   • Format each entry as:

     - \

     /name` -- description`
   • Sort entries alphabetically by name.
   • Keep a blank line after the heading and after the last entry.
4. Update

   dotfiles/hal_dotfiles.json

   :
   • Read the current file and parse the

     copies

     array.
   • Replace all

     .claude/skills/*

     entries with entries for each discovered skill directory (regardless of

     user-invocable

     ).
   • Format each entry as:

     {"dest": "{{HOME}}/.claude/skills/<name>/", "src": ".claude/skills/<name>/"}

   • Sort skill entries alphabetically by name.
   • Preserve all non-skill entries in

     copies

     (and the entire

     links

     array) exactly as-is.
5. Run

   hal sync

   to deploy the updated files.
6. Report what changed: list any skills added or removed from each file.