# skills

Personal agent skills packaged through Nix.
The domain glossary lives at `$(xdg-user-dir DOCUMENTS)/ai-artifacts/projects/skills/CONTEXT.md`.

## Conventions

- `AGENTS.md` is canonical for project instructions.
  Context, ADRs, specs, and tasks live under `$(xdg-user-dir DOCUMENTS)/ai-artifacts/projects/skills/`.
- Skill source lives under `skills/<name>/`.
  Do not edit generated links under `.agents/skills/` or `.claude/skills/` as source.
- Run `nix flake check` before considering a repository-wide change complete.
  The check builds every packaged skill plus the Home Manager module, shell hook, and benchmark core tests.
- The dev shell may place Nix-delivered skills into `.agents/skills/` and maintain `.claude/skills` as a compatibility symlink.
  Generated ignore entries belong in the root `.gitignore`, not inside `.agents/skills/`, because skill scanners honor ignore files inside scanned skill directories.

## Gotchas

- `python3` is supplied by the default Nix dev shell, not the ambient environment.
  Enter `nix develop` before running Python-based project tools.