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?