32 lines
1.7 KiB
Markdown
32 lines
1.7 KiB
Markdown
# 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.
|
|
|
|
## Gotchas
|
|
|
|
- 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.
|