# Skill Maintenance Checklist

Use this checklist when editing the `agent-docs` skill suite itself: any `SKILL.md`, `agents/openai.yaml`, or shared file under `references/`.

- Did you run `scripts/validate_agent_docs.py --skill-suite-root <skills-root>` after the edit?
- Does each `agents/openai.yaml` still match the skill title, scope, and trigger language in the corresponding `SKILL.md`?
- Is every file in `references/` directly referenced from the router skill or the specialized skill that requires it?
- Are there stale filenames, old skill names, or outdated terms left behind after renames or splits?
- Does one concept still use one term across `SKILL.md`, `agents/openai.yaml`, and `references/`?
- If a shared checklist or template changed, do the affected skills still point to the right file and workflow step?