Agents

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.

42 min · 2026-08-20 · Watch on YouTube

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

Chapters

  1. 1:45What AGENTS.md does
  2. 13:42What a skill is, with a live install
  3. 20:00Which layer to use for which job
  4. 26:13How MCP works
  5. 34:25Live YouTube transcript MCP test
Free live lesson · Nov 24Stop Measuring AI by Tokens. Measure What It EarnsOne hour, live, with Saurav. Bring your own bill. Free.
Save my free seat →
Get new videos and tips by emailOne short email when there is something new. Unsubscribe any time.

More CloudYeti videos