Video summary
CLAUDE.md, AGENTS.md and SKILL.md Explained for Beginners
Main summary
Key takeaways
Main Ideas
- README.md, CLAUDE.md, AGENTS.md, and SKILL.md are Markdown files. The
.mdextension 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
.skillsfolder is just a folder, not a new file format. It holds skills, and each skill can have its own folder containing askill.mdfile. Skills are not limited to Claude.
Practical Guide
- Put project information intended for people in README.md.
- Put rules that apply across the project in CLAUDE.md or AGENTS.md.
- Put the repeatable steps for an individual job in a skill.
- Store skills in the tool’s designated skills folder, such as .skills, with each skill’s instructions in a Markdown file.
- 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.
Translate summary in another language
Ask questions to this video
Chat for follow-up questions, clarifications, and source-backed answers.