LLM-useful CLI tools and agent skills, packaged with Nix.

Installs into both Claude Code and opencode by default — each skill is symlinked into every directory listed in programs.ak2k-skills.skillDirs.

Structure and approach is inspired by Mic92/mics-skills.

Bundles are skill sets re-exported from another flake as a single unit. Each bundle contributes many entries to the registry, all sharing one package.

Add as a flake input and import the home-manager module:

# flake.nix
inputs.ak2k-skills.url = "github:ak2k/ak2k-skills";
inputs.ak2k-skills.inputs.nixpkgs.follows = "nixpkgs-unstable";

home-manager.sharedModules = [
  inputs.ak2k-skills.homeManagerModules.default
];

# home.nix or darwin.nix
programs.ak2k-skills = {
  enable = true;

  # Default: every registered skill, including the entire gws bundle.
  # Pass an explicit list to install a subset:
  # skills =
  #   [ "claude-sessions" "krisp-cli" "msgvault-query" ]
  #     ++ inputs.ak2k-skills.lib.bundles.gws;

  # Default: [ ".claude/skills" ".opencode/skills" ].
  # Override to target only one harness:
  # skillDirs = [ ".claude/skills" ];
};

The module installs each selected skill's CLI (if one exists) into home.packages and symlinks the skill definition at ~/<skillDir>/<name>/ for every configured skillDir.

# List every registered skill:
nix eval .#legacyPackages.aarch64-darwin.skill-registry --apply builtins.attrNames

# List skills in the gws bundle:
nix eval .#lib.bundles.gws --json | jq

1. Create <name>/ with <name>.py, pyproject.toml, default.nix, plus the skill definition under skills/<name>/SKILL.md.
2. In <name>/default.nix, add a postInstall that copies ../skills/<name>/. into $out/share/skills/<name>/ (copy the shape from krisp-cli/default.nix).
3. Register the package in flake.nix under perSystem.packages.
4. Add a registry entry in nix/registry.nix pointing source at $out/share/skills/<name> and package at the new package.

For a docs-only skill (no binary), skip the package and point source at the source tree directly — see the siplink entry as an example.

Bundles re-use one upstream flake's binary across many skills. To add one:

1. Add the upstream flake as an input in flake.nix.
2. Re-export its binary in perSystem.packages.<name>.
3. Extend nix/registry.nix to enumerate the upstream's skills/ tree (readDir + filterAttrs by SKILL.md existence) and emit one registry entry per directory, each pointing at the same package and tagged bundle = "<name>".
4. Expose flake.lib.bundles.<name> for ergonomic consumer composition.