MCP vs Skills vs AGENTS.md: which one do you need?
AGENTS.md, skill.md, and MCP are three places to put knowledge for an agent. AGENTS.md holds always-on rules, skills hold repeatable guidance, and MCP connects the agent to outside systems.
The main idea
Many people treat AGENTS.md, skill.md, and MCP as three competing ways to set up an agent. In the live session I build all three in an empty workspace with Codex and show what each one does.
AGENTS.md is a text file that works like a system prompt. Codex loads it into context every time. I put rules there, such as always write 101-level content and use language that works worldwide. Claude Code reads CLAUDE.md instead of AGENTS.md. I also keep a docs folder and point to a video instructions file from AGENTS.md, so the agent loads that detail only when it needs it.
A skill is also a text file. It holds repeatable guidance for a job you do sometimes, like making a video. The agent loads the skill only when the task calls for it. I installed a free video script skill from skills.sh and asked the agent to draft a tweet with it.
MCP is a protocol. An MCP client, which is the agent, connects to an MCP server that exposes tools, such as read ticket or write wiki. I added a YouTube transcript MCP server to Codex and it pulled the transcript of my latest video. That job could also have been done with a skill, so it was not the best example of when MCP is needed. Be careful with free skills and MCP servers from the internet. I once almost installed a malicious skill.
Key points
- AGENTS.md is a text file loaded into context by default, like a reusable system prompt. Claude Code uses CLAUDE.md instead.
- Keep AGENTS.md short and point to a docs folder, so the agent loads detailed instructions only when needed.
- A skill is a text file for a job you only do sometimes, and it loads when the task triggers it.
- MCP is a client and server protocol. The server exposes tools, and the agent discovers them with a tools list request.
- Some MCP connections can be replaced by a skill plus a CLI, for example the gh CLI for GitHub.
- Free skills and MCP servers can be malicious, so check them before you install them.
Chapters
- 1:45What AGENTS.md does
- 13:42What a skill is, with a live install
- 20:00Which layer to use for which job
- 26:13How MCP works
- 34:25Live YouTube transcript MCP test
Save my free seat →