skills

Personal agent skills packaged through Nix.

Conventions

AGENTS.md is the canonical source for project instructions.
Skill source lives under skills/<name>/. Do not edit generated links under .agents/skills/ or .claude/skills/.
Deprecated skill source lives under deprecated/<name>/.
Run nix flake check before marking a repository-wide change complete. The check builds every packaged skill plus the Home Manager module and shell hook.
The dev shell can place Nix-delivered skills into .agents/skills/. It can maintain .claude/skills as a compatibility symlink. Generated ignore entries belong in the root .gitignore, not inside .agents/skills/. Skill scanners honor ignore files inside scanned skill directories.

This repository owns packaged skill sources only. Enabling, replacing, or removing them in a consumer repository such as dotfiles is outside its scope.
nix flake check evaluates the Git snapshot and omits untracked skill files. Use nix flake check "path:$PWD" to include a newly created skill before staging it.
Do not turn opportunistic use of another skill into a declared dependency. The agent can invoke an unrelated skill at its discretion unless the current skill directly requires its contract.
When adapting an upstream skill, preserve mechanics the upstream skill leaves unspecified. Treat deliberate ambiguity as part of the skill's design. Customize only the parts required to fit the local workflow. Do not turn incidental choices into new contracts.
Document helper commands with their location, not only a bare ./helper invocation. Agents may run skill instructions from the caller's current working directory instead of the skill directory.