Migrating Claude Assets to Home-Manager

Overview

This repo manages Claude Code skills and commands via home-manager. Source files live in assets/claude/, deployed to ~/.claude/ via symlinks.

File Locations

| Type | Source | Deployed to | |------|--------|-------------| | Commands | assets/claude/commands/<name>.md | ~/.claude/commands/<name>.md | | Skills | assets/claude/skills/<name>/SKILL.md | ~/.claude/skills/<name>/SKILL.md | | References | assets/claude/skills/<name>/references/*.md | ~/.claude/skills/<name>/references/*.md |

Migration Steps

1. Copy files to assets

# For a command
cp ~/.claude/commands/my-command.md assets/claude/commands/

# For a skill (may have references/)
cp -r ~/.claude/skills/my-skill assets/claude/skills/

2. Add home.file entries

Edit users/dev/home.base.nix, add entries after existing ones (~line 166):

# For a command
home.file.".claude/commands/my-command.md".source = "${assetsPath}/claude/commands/my-command.md";

# For a skill
home.file.".claude/skills/my-skill/SKILL.md".source = "${assetsPath}/claude/skills/my-skill/SKILL.md";

# For each reference file (if any)
home.file.".claude/skills/my-skill/references/FOO.md".source = "${assetsPath}/claude/skills/my-skill/references/FOO.md";

3. Remove existing files (before applying)

Home-manager can't overwrite regular files with symlinks:

# On macOS
rm ~/.claude/commands/my-command.md
# or
rm -rf ~/.claude/skills/my-skill

# On devbox (if existed there too)
rm -rf ~/.claude/skills/my-skill

4. Commit and push

git add assets/claude/ users/dev/home.base.nix
git commit -m "Migrate my-skill to home-manager"
git push origin main

5. Apply

macOS:

sudo darwin-rebuild switch --flake ~/Code/workstation#Y0FMQX93RR-2

Devbox:

cd ~/projects/workstation && git pull
nix run home-manager -- switch --flake .#dev

Notes

• Each file needs explicit home.file entry (not recursive)
• Skills deploy to both macOS and devbox via shared home.base.nix
• Skill frontmatter: needs name: and description: fields
• Command frontmatter: needs description: field