Files
skills/AGENTS.md

1.1 KiB

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

  • The development environment does not provide python3 by default. Use available project tools instead of assuming Python is installed.