juanibiapina/dotfiles/managing-skills

Managing Skills

Two kinds: own (local, editable) and external (from GitHub repos, read-only in nix store).

Files involved:

• agents/skills/ - own skills directory
• flake.nix - flake inputs for external sources
• nix/modules/homemanager/agents.nix - source wiring

All skills end up at ~/.agents/skills/<name>/.

Own Skills

Create dir under agents/skills/ with SKILL.md. Own skills get live symlinks back to repo (editable without rebuild).

agents/skills/my-skill/SKILL.md

Stage new files, run make.

External Skills

Add flake input in flake.nix, wire source in agents.nix. Three patterns:

All skills from repo

Repo has skills/ dir with multiple skill subdirs.

# flake.nix
websearch = { url = "github:example/websearch-skills"; flake = false; };
 
# agents.nix sources
websearch = { src = inputs.websearch; subdir = "skills"; };

Cherry-pick from repo

Repo has nested skill dirs. Pick specific ones by relative path under subdir. Installed name is last path component.

# agents.nix sources
agent-library = {
  src = inputs.agent-skills-library;
  subdir = "skills";
  pick = [
    "design/radix-ui-design-system"
    "business/seo-audit"
  ];
};

Single skill (no subdir)

Entire repo is one skill. Attribute name becomes skill name.

# flake.nix
last30days-skill = { url = "github:mvanhorn/last30days-skill"; flake = false; };
 
# agents.nix sources
last30days = { src = inputs.last30days-skill; };

Removing Skills

Own: delete dir from agents/skills/. External: remove flake input from flake.nix and source entry from agents.nix.

Applying Changes

git add flake.nix nix/modules/homemanager/agents.nix  # stage new/changed files
gob run make

Own skill names must not collide with external skill names (build will fail).