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:
- Goal: The intended result.
- Context: Relevant facts, sources, and inputs.
- Requirements and constraints: Required behavior, limits, and authorization boundaries.
- Success criteria: Evidence that the work is complete.
- Output: The deliverables and their format.
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.