AGENTS.md vs. SKILL.md

AGENTS.md contains rules that apply across tasks in its scope. Add clear, actionable rules under useful topic headings as you notice repeated problems. Preserve established choices when revising existing rules.

SKILL.md contains reusable instructions for a specific task. General autonomy and workflow rules belong in AGENTS.md. Skills add the requirements and exceptions needed for their task.

My instruction-design skill uses five parts for prompts and skills:

Simple prompts can combine these parts without separate headings. Agent rule files use actionable rules under topic headings. Define the result and required evidence, then let the agent choose its method unless correctness, permissions, or fragile operations require a procedure.