# nix-skills

Nix expressions for AI agent skills from [skills.sh](https://skills.sh) and [skillsdirectory.com](https://www.skillsdirectory.com). Two independent GitHub Actions workflows keep the data fresh: [Fetch Sources](https://github.com/sudosubin/nix-skills/actions/workflows/fetch-sources.yml) and [Update Skills](https://github.com/sudosubin/nix-skills/actions/workflows/update-skills.yml), each running every 3 hours.

As of March 2026, this flake provides Nix derivations for over **480,000** skills sourced from nearly **13,000** GitHub repositories. Each **skill** is individually packaged, pinned to a specific revision, and made available through a nixpkgs overlay.

## Prerequisites

### (Optional) Enable flakes

Read about [Nix flakes](https://wiki.nixos.org/wiki/Flakes) and [set them up](https://wiki.nixos.org/wiki/Flakes#Setup).

## Overlay

Read about [Overlays](https://wiki.nixos.org/wiki/Overlays#Using_overlays).

### With flakes

Add `nix-skills` to your flake inputs:

```nix { inputs = { nixpkgs.url = "github:nixos/nixpkgs/nixpkgs-unstable"; nix-skills.url = "github:sudosubin/nix-skills"; };

outputs = { nixpkgs, nix-skills, ... }: let pkgs = import nixpkgs { system = "aarch64-darwin"; # or "x86_64-linux", etc. overlays = [ nix-skills.overlays.default ]; }; in { # pkgs.skills.<owner>.<repo>.<skill-name> }; } ```

### Without flakes

```nix let nix-skills = import (builtins.fetchGit { url = "https://github.com/sudosubin/nix-skills"; ref = "refs/heads/main"; });

pkgs = import <nixpkgs> { overlays = [ nix-skills.overlays.default ]; }; in # pkgs.skills.<owner>.<repo>.<skill-name> ```

## Usage

### Get `skills`

#### Get `skills` via the overlay

After applying the overlay (see [Overlay](#overlay)), skills are available under `pkgs.skills`:

```nix pkgs.skills.<owner>.<repo>.<skill-name> ```

#### Get `skills` from `nix-skills` directly

Without the overlay, you can acce