aboutsummaryrefslogtreecommitdiffstats
path: root/nix/home-manager.nix
blob: 53db6585fe4529b227d79080f79480f73c3087c4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
self:
{
  config,
  lib,
  pkgs,
  ...
}:

let
  cfg = config.programs.skills;
  lock = lib.importJSON cfg.lockFile;

  fetch =
    src:
    builtins.fetchTree (
      {
        type = "git";
        inherit (src) url rev;
        allRefs = true;
      }
      # With a narHash Nix reuses what `skills` already put in the store, so
      # private sources work even when root evaluates this without SSH keys.
      // lib.optionalAttrs (src ? narHash) { inherit (src) narHash; }
    );

  skills = lib.concatMapAttrs (
    _: src:
    let
      tree = fetch src;
    in
    lib.mapAttrs (_: path: "${tree}/${path}") src.skills
  ) lock.sources;

  linkInto = dir: lib.mapAttrs' (name: path: lib.nameValuePair "${dir}/${name}" { source = path; }) skills;
in
{
  options.programs.skills = {
    enable = lib.mkEnableOption "agent skills from a skills lock file";

    package = lib.mkOption {
      type = lib.types.package;
      default = self.packages.${pkgs.stdenv.hostPlatform.system}.default;
      defaultText = lib.literalExpression "skills.packages.\${system}.default";
      description = "The skills CLI.";
    };

    lockFile = lib.mkOption {
      type = lib.types.path;
      example = lib.literalExpression "./skills.lock";
      description = "The skills.lock whose skills to install.";
    };

    manifest = lib.mkOption {
      type = lib.types.nullOr lib.types.str;
      default = null;
      example = "/home/me/dotfiles/skills.json";
      description = ''
        Absolute path of the writable skills.json next to {option}`lockFile`,
        so that `skills add` and `skills update` edit your configuration.
      '';
    };

    agents = lib.mkOption {
      type = lib.types.listOf (
        lib.types.enum [
          "claude"
          "codex"
          "opencode"
        ]
      );
      default = [ "claude" ];
      description = "Agents to install the skills into.";
    };
  };

  config = lib.mkIf cfg.enable {
    assertions = [
      {
        assertion = lock.version or null == 1;
        message = "programs.skills.lockFile has an unsupported version; upgrade skills.";
      }
    ];

    home.packages = [ cfg.package ];

    home.sessionVariables = {
      SKILLS_MANAGED_BY = "home-manager";
    }
    // lib.optionalAttrs (cfg.manifest != null) { SKILLS_MANIFEST = cfg.manifest; };

    home.file = lib.mkMerge [
      (lib.mkIf (lib.elem "claude" cfg.agents) (linkInto ".claude/skills"))
      (lib.mkIf (lib.elem "codex" cfg.agents) (linkInto ".codex/skills"))
    ];

    xdg.configFile = lib.mkIf (lib.elem "opencode" cfg.agents) (linkInto "opencode/skills");
  };
}