Skills & .md files
What is the difference between CLAUDE.md and a skills file?
By Mika Reyes and Nick Reyes ·
Short answer
CLAUDE.md is the standing briefing Claude Code reads for every session in a project: who you are, how you work, and what good output looks like. A skill is a focused Markdown playbook for one job, like drafting a tweet or a meeting recap, that you invoke with a slash command when you need it.
The longer answer
CLAUDE.md is the standing briefing: who you are, how you work, which tools exist, what good output looks like. Claude treats it as baseline context for the project.
A skill is a focused .md playbook for one job—tweet draft, standup prep, meeting recap—usually invoked with a / command.
Handbook versus task card: the handbook stays on; the card comes out when you need that specific outcome.
Related questions
Learn Claude Code hands-on
These answers come from our Maven Lightning Lesson Q&A. To build your own agent setup with CLAUDE.md, skills, and MCPs step by step, join Master Claude Code as a Non-Technical Pro or browse all Claude Code for Non-Technical Pros guides.
Using an AI assistant? Give it the Markdown version of this answer.