fix(skills): clarify skill guidance

This commit is contained in:
2026-10-18 15:40:23 -04:00
parent 5a5543633c
commit 898a6df333

View File

@@ -41,4 +41,4 @@ You have access to several files in the repo:
- `AGENTS.md`: these files are pushed to the context window of any agent working in this repo. They should be used incredibly sparingly, usually only for **navigation pointers** to other files.
- **Review standards**: these are the documented rules that the repository's review workflow loads. They can live in a standards file, a contribution guide, or scoped rule files. Find the existing source before proposing an addition.
- Docs: use docs as references files, pointed to by other files. Look for existing docs before writing new ones.
- Skills: use skills for docs (since their description goes into the agent's context window), or for user-invoked commands. Follow the advice in the `agent-writing-guide` skill.
- Skills: use skills for user-invoked commands or model-discoverable guidance. Follow the advice in the `agent-writing-guide` skill.