alexion/skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update project agent instructions

Browse Source
This commit is contained in:
alexion
2026-08-26 19:08:23 -04:00
parent 9195cf3ee7
commit 25df5f8555
1 changed files with 11 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
AGENTS.md
View File

@@ -1,35 +1,29 @@
# skills # skills
Personal agent skills packaged through Nix. Personal agent skills packaged through Nix.
The domain glossary lives at `$(xdg-user-dir DOCUMENTS)/ai-artifacts/projects/skills/011-skills-context.md`.
## Conventions ## Conventions
- `AGENTS.md` is canonical for project instructions. - `AGENTS.md` is the canonical source for project instructions.
Context, ADRs, specs, and tasks live under `$(xdg-user-dir DOCUMENTS)/ai-artifacts/projects/skills/`.
- Skill source lives under `skills/<name>/`. - Skill source lives under `skills/<name>/`.
Do not edit generated links under `.agents/skills/` or `.claude/skills/` as source. Do not edit generated links under `.agents/skills/` or `.claude/skills/`.
- Deprecated skill source lives under `deprecated/<name>/`. - Deprecated skill source lives under `deprecated/<name>/`.
- Run `nix flake check` before considering a repository-wide change complete. - 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 check builds every packaged skill plus the Home Manager module and shell hook.
- The dev shell may place Nix-delivered skills into `.agents/skills/` and maintain `.claude/skills` as a compatibility symlink. - The dev shell can place Nix-delivered skills into `.agents/skills/`.
Generated ignore entries belong in the root `.gitignore`, not inside `.agents/skills/`, because skill scanners honor ignore files inside scanned skill directories. 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 ## Gotchas
- A skill-local `GLOSSARY.md` is runtime reference for that skill and has no relationship to the project's AI-artifacts-vault context glossary.
- This repository owns packaged skill sources only. - This repository owns packaged skill sources only.
Enabling, replacing, or removing them in a consumer repository such as dotfiles is outside its scope. 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. - `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. Use `nix flake check "path:$PWD"` to include a newly created skill before staging it.
- `$(xdg-user-dir DOCUMENTS)/ai-artifacts` is itself an Obsidian vault for AI-generated artifacts, distinct from the personal vault where AI-generated notes are forbidden.
- Project artifact filenames carry globally allocated identifiers.
Discover context and ADR artifacts through the AI artifacts vault convention rather than assuming fixed names or type directories.
- Do not turn opportunistic use of another skill into a declared dependency. - Do not turn opportunistic use of another skill into a declared dependency.
Invocation of an unrelated skill remains the agent's discretion unless the current skill directly requires its contract. The agent can invoke an unrelated skill at its discretion unless the current skill directly requires its contract.
- Do not instruct a skill to execute synchronously.
In-process execution is the baseline, while isolation and parallelism belong to an external caller or runtime.
- When adapting an upstream skill, preserve mechanics the upstream skill leaves unspecified. - When adapting an upstream skill, preserve mechanics the upstream skill leaves unspecified.
Customize only the surfaces required to fit the local workflow rather than turning incidental choices into new contracts. Treat deliberate ambiguity as part of the skill's design.
- The installed `gitea-axi pr view` does not support `--fields`. Customize only the parts required to fit the local workflow.
Use plain `gitea-axi pr view <number>`. Do not turn incidental choices into new contracts.