Codex AGENTS.md Guide

Users searching for Codex AGENTS.md are usually comparing two layers of configuration: the runtime-level conventions that shape agent behavior and the reusable skill packages that define repeatable workflows. Codex skills is the main browse page, and this guide explains how the two layers work together.

A simple mental model

• AGENTS.md describes agent behavior and repo context.
• skills package reusable workflows and operating procedures.

In real teams, the two often work together rather than compete.

When to use each

Use the Codex platform page when you are discovering inventory. Use this guide when your question is practical: should a workflow live in AGENTS.md, a skill, or both?

Recommended next steps

• Codex skills
• How to use Codex skills
• Agent Skills vs MCP