● Сообщество
Kyure-A
⚡ Сразу
agent-skills-nix
автор 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.
Зачем использовать
Ключевые функции
- 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
Живое демо
Как выглядит на практике
agent-skills-nix-skill.replay
▶ готово
Сценарии использования
Реальные сценарии: agent-skills-nix
Когда использовать: You want your Claude skill set tracked the same way as your shells, editors, and services.
Предварительные требования
- 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";
Поток
-
Add the input
Add agent-skills-nix to my flake inputs and wire it into Home Manager.✓ Скопировано
→ 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.✓ Скопировано
→ A skills = { ... }; block with pinned revs
Итог: Reproducible skill set managed by Nix — wipe your dotfiles and get the same setup back in one command.
Подводные камни
- Upstream skill changes break your workflow — Pin to a specific rev, only bump on purpose
Когда использовать: You switch between a laptop and a desktop and keep forgetting to clone the same skills on both.
Поток
-
Add to your shared HM module
Move the skills declaration into my shared home-manager module so both hosts import it.✓ Скопировано
→ Single source of truth, two hosts consuming it
Итог: Both machines carry the same skill bundle automatically.
Подводные камни
- Forgetting to commit and push before switching on the second machine — Use a self-flake with autoCommit or a shared git repo
Комбинации
Сочетайте с другими MCP — эффект 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.✓ Скопировано
Стоимость и лимиты
Во что обходится
- Квота API
- none
- Токенов на вызов
- minimal — Nix declarations are short
- Деньги
- free
- Совет
- Keep your skill set small — every skill costs context tokens at load time
Безопасность
Права, секреты, радиус поражения
Хранение учётных данных: none
Исходящий трафик: fetches only the skill repos you declare
- Nix fetches from the git URLs you declare — vet the source before adding to your flake
Устранение неполадок
Частые ошибки и исправления
Flake doesn't evaluate
Check input url format and run nix flake check for specific errors.
Проверить: nix flake check
Pinned rev 404
The upstream repo may have rewritten history — update the rev.
Альтернативы
agent-skills-nix в сравнении
| Альтернатива | Когда использовать | Компромисс |
|---|
| 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 |