# What is the difference between CLAUDE.md and a skills file?

Source: https://www.kingscrosslabs.com/guides/claude-code/claude-md-vs-skills
Author: Mika Reyes, Nick Reyes (King's Cross Labs)
Published: 2026-05-07
Updated: 2026-11-16
Topic: Skills & .md files

## 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.

> Maven workshop: Skill design and `CLAUDE.md` wiring are covered hands-on in [our Maven workshop](https://maven.com/mika-reyes/master-claude-code-as-a-non-technical-pro).

---
Cite this page as: https://www.kingscrosslabs.com/guides/claude-code/claude-md-vs-skills