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.

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.