● Comunidade
Kyure-A
⚡ Instantâneo
agent-skills-nix
por 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.
Por que usar
Principais recursos
- 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
Demo ao vivo
Como fica na prática
agent-skills-nix-skill.replay
▶ pronto
Casos de uso
Usos do mundo real: agent-skills-nix
Quando usar: You want your Claude skill set tracked the same way as your shells, editors, and services.
Pré-requisitos
- 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";
Fluxo
-
Add the input
Add agent-skills-nix to my flake inputs and wire it into Home Manager.✓ Copiado
→ 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.✓ Copiado
→ A skills = { ... }; block with pinned revs
Resultado: Reproducible skill set managed by Nix — wipe your dotfiles and get the same setup back in one command.
Armadilhas
- Upstream skill changes break your workflow — Pin to a specific rev, only bump on purpose
Quando usar: You switch between a laptop and a desktop and keep forgetting to clone the same skills on both.
Fluxo
-
Add to your shared HM module
Move the skills declaration into my shared home-manager module so both hosts import it.✓ Copiado
→ Single source of truth, two hosts consuming it
Resultado: Both machines carry the same skill bundle automatically.
Armadilhas
- Forgetting to commit and push before switching on the second machine — Use a self-flake with autoCommit or a shared git repo
Combinações
Combine com outros MCPs para 10× de alavancagem
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.✓ Copiado
Custo e limites
O que custa rodar
- Cota de API
- none
- Tokens por chamada
- minimal — Nix declarations are short
- Monetário
- free
- Dica
- Keep your skill set small — every skill costs context tokens at load time
Segurança
Permissões, segredos, alcance
Armazenamento de credenciais: none
Saída de dados: fetches only the skill repos you declare
- Nix fetches from the git URLs you declare — vet the source before adding to your flake
Solução de problemas
Erros comuns e correções
Flake doesn't evaluate
Check input url format and run nix flake check for specific errors.
Verificar: nix flake check
Pinned rev 404
The upstream repo may have rewritten history — update the rev.
Alternativas
agent-skills-nix vs. outros
| Alternativa | Quando usar | Troca |
|---|
| 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 |