Video summary

CLAUDE.md, AGENTS.md and SKILL.md Explained for Beginners

Main summary

Key takeaways

Educational

Main Ideas

  • README.md, CLAUDE.md, AGENTS.md, and SKILL.md are Markdown files. The .md extension means they use plain text with simple formatting symbols, such as # for headings and - for lists.
  • The filename signals the file’s intended reader and purpose:
    • README.md is written for people. It explains what a project is and how to use it.
    • CLAUDE.md contains project-wide rules for Claude Code. The video says Claude Code reads it automatically each session, allowing the AI to follow those rules alongside a user’s request.
    • AGENTS.md serves a similar purpose for AI agents. The video names Codex, Copilot, and Cursor as examples, and says Claude can also read it when there is no CLAUDE.md. Some tools may have their own files, such as GEMINI.md.
    • A skill contains the procedure for one specific, repeatable task, such as preparing a monthly report.
  • Project-wide rules and task-specific procedures should be separated. Rules apply broadly, while a skill’s steps apply only when that particular task is needed. Putting every task into one large rules file can make it long and harder for the AI to use effectively.
  • Skills are loaded selectively. The AI can first see a skill’s name and short description, then open its full instructions when a relevant task comes up. The video compares this to checking a cookbook’s contents and opening only the recipe you need.
  • The .skills folder is just a folder, not a new file format. It holds skills, and each skill can have its own folder containing a skill.md file. Skills are not limited to Claude.

Practical Guide

  1. Put project information intended for people in README.md.
  2. Put rules that apply across the project in CLAUDE.md or AGENTS.md.
  3. Put the repeatable steps for an individual job in a skill.
  4. Store skills in the tool’s designated skills folder, such as .skills, with each skill’s instructions in a Markdown file.
  5. Remember the core distinction: project-wide rule = CLAUDE.md or AGENTS.md; steps for one job = skill.

Speakers and Sources Featured

  • Narrator: The video’s unnamed presenter, explaining the files and giving examples.
  • Examples mentioned by the narrator: Claude Code, Codex, Copilot, Cursor, and Gemini. These are cited as AI tools, not as separate speakers.

Rate this summary

Your feedback will help improve summaries.

Improve this summary

Reprocess with a stronger model when the summary feels incomplete or inaccurate.

Pro

Translate summary in another language

Pro

Ask questions to this video

Chat for follow-up questions, clarifications, and source-backed answers.

Coming soon

Share this summary

Original video