Install Agent Skills

Deploy generated skills from dotfiles/ to system locations.

Usage

/install-agent-skills # Install ALL skills /install-agent-skills zod-docs # Install only zod-docs skill

Run after /generate-agent-skills .

How It Works

The install script:

• Copies SKILL.md from dotfiles/<agent>/skills/<skill>/

• Creates a symlink references/ pointing to dotfiles/shared/<skill>/

This keeps the repo clean (no symlinks) while installed skills link to shared docs.

Instructions

Step 1: Check Arguments

Check if $ARGUMENTS is provided:

• If argument provided: Install only that specific skill

• If no argument: Install all skills

Step 2: Verify skills exist

If installing a specific skill:

• Verify dotfiles/shared/{argument}/ exists

• Verify dotfiles/claude/skills/{argument}/ exists

• If not found, tell user to run /generate-agent-skills {argument} first

If installing all skills:

• Check that dotfiles/shared/ and dotfiles/*/skills/ contain skills

• If empty, tell user to run /generate-agent-skills first

Step 3: Install skills

Use the install.sh script:

For a specific skill:

SKILL="{argument}"

Claude Code

.claude/skills/install-agent-skills/scripts/install.sh "dotfiles/claude/skills/$SKILL" ~/.claude/skills

Codex CLI

.claude/skills/install-agent-skills/scripts/install.sh "dotfiles/codex/skills/$SKILL" ~/.codex/skills

OpenCode

.claude/skills/install-agent-skills/scripts/install.sh "dotfiles/opencode/skills/$SKILL" ~/.config/opencode/skills

For all skills:

Claude Code skills -> ~/.claude/skills/

for skill in dotfiles/claude/skills/*/; do .claude/skills/install-agent-skills/scripts/install.sh "$skill" ~/.claude/skills done

Codex skills -> ~/.codex/skills/

for skill in dotfiles/codex/skills/*/; do .claude/skills/install-agent-skills/scripts/install.sh "$skill" ~/.codex/skills done

OpenCode skills -> ~/.config/opencode/skills/

for skill in dotfiles/opencode/skills/*/; do .claude/skills/install-agent-skills/scripts/install.sh "$skill" ~/.config/opencode/skills done

Step 4: Report results

Summarize skills installed per agent.

Standalone Usage

Default: symlink mode (references/ links to shared docs)

.claude/skills/install-agent-skills/scripts/install.sh dotfiles/claude/skills/codex-docs ~/.claude/skills

Copy mode: copies docs, creates standalone skill

.claude/skills/install-agent-skills/scripts/install.sh dotfiles/claude/skills/codex-docs ~/.claude/skills --copy

Installed Structure

After installation, each skill in ~/.claude/skills/ (or equivalent) contains:

• SKILL.md

• Agent-specific skill definition

• references/

• Symlink to <repo>/dotfiles/shared/<docs>/

Updates to dotfiles/shared/ are immediately reflected in all installed skills.