● Communauté
Kyure-A
⚡ Instantané
agent-skills-nix
par Kyure-A · Kyure-A/agent-skills-nix
Manage your Claude Agent Skills declaratively with Nix — reproducible skill sets across machines.
A Nix flake that lets you declare your Agent Skills in Nix config and have them materialized into ~/.claude/skills/ (or any target). Useful if you already live in NixOS or Home Manager and want your skill setup to be as reproducible as the rest of your dotfiles.
Pourquoi l'utiliser
Fonctionnalités clés
- Declarative: skills defined in
flake.nix or Home Manager module - Reproducible across machines — same lock, same skills
- Pins skills to a specific git rev for stability
- Plays nicely with Home Manager
- No more 'works on my laptop' skill drift
Démo en direct
Aperçu en pratique
agent-skills-nix-skill.replay
▶ prêt
Cas d'usage
Usages concrets : agent-skills-nix
Quand l'utiliser : You want your Claude skill set tracked the same way as your shells, editors, and services.
Prérequis
- Nix with flakes enabled — echo 'experimental-features = nix-command flakes' >> ~/.config/nix/nix.conf
- The flake added as an input — flake input
agent-skills-nix.url = "github:Kyure-A/agent-skills-nix";
Déroulement
-
Add the input
Add agent-skills-nix to my flake inputs and wire it into Home Manager.✓ Copié
→ flake.nix updated with the input + module import
-
List the skills I want
Declare the skills I use: linear-claude-skill, symfony-ux-skills, mck-ppt-design-skill. Pin to current main.✓ Copié
→ A skills = { ... }; block with pinned revs
Résultat : Reproducible skill set managed by Nix — wipe your dotfiles and get the same setup back in one command.
Pièges
- Upstream skill changes break your workflow — Pin to a specific rev, only bump on purpose
Quand l'utiliser : You switch between a laptop and a desktop and keep forgetting to clone the same skills on both.
Déroulement
-
Add to your shared HM module
Move the skills declaration into my shared home-manager module so both hosts import it.✓ Copié
→ Single source of truth, two hosts consuming it
Résultat : Both machines carry the same skill bundle automatically.
Pièges
- Forgetting to commit and push before switching on the second machine — Use a self-flake with autoCommit or a shared git repo
Combinaisons
Associez-le à d'autres MCPs pour un effet X10
Claude reads your flake and suggests skills to add/remove
Read my flake.nix, check which of my installed skills haven't been used in 30 days, and suggest removals.✓ Copié
Coût et limites
Coût d'exécution
- Quota d'API
- none
- Tokens par appel
- minimal — Nix declarations are short
- Monétaire
- free
- Astuce
- Keep your skill set small — every skill costs context tokens at load time
Sécurité
Permissions, secrets, portée
Stockage des identifiants : none
Sortie de données : fetches only the skill repos you declare
- Nix fetches from the git URLs you declare — vet the source before adding to your flake
Dépannage
Erreurs courantes et correctifs
Flake doesn't evaluate
Check input url format and run nix flake check for specific errors.
Vérifier : nix flake check
Pinned rev 404
The upstream repo may have rewritten history — update the rev.
Alternatives
agent-skills-nix vs autres
| Alternative | Quand l'utiliser | Compromis |
|---|
| manual git clone | You're not on Nix and don't want to be | No reproducibility; easy drift |
| agent-skills-cli-skill | You want a CLI installer without Nix | Imperative rather than declarative |