Vibe Coder · Unit 9: Claude Code Commands and Extensions · Lesson 4 of 10

Skills

A skill packages instructions, and optionally scripts and files, for one kind of task. Claude Code loads it when the task calls for it.

Read the short notes and pictures.Do everything inside a blue frame.

Skills for building

In Claude Code a skill is a folder containing a SKILL.md file with a name, a description and instructions, plus any scripts or reference files. Because only the description is loaded up front, you can have many skills without crowding the context.

A 3D scene of coloured blocks and cards. A skill is a folder: skills/design-system/,   SKILL.md,   tokens.json.
A folder with instructions and supporting files.

Skill, command or CLAUDE.md?

CLAUDE.md

Rules that apply to everything in the project.

Skill

A method for one kind of task, loaded when relevant.

Command

Something you trigger yourself by name.

A 3D scene of coloured blocks and cards. Loaded when needed: short description, task matches, full skill.
Only the description is read until a task matches.

Writing a good one

  1. Describe when to use it

    The description decides whether it loads.

  2. Write the steps

    As you would brief a colleague.

  3. Include what it needs

    Templates, examples, a script.

  4. Test in a fresh session

    Ask for the task without mentioning the skill.

ActivityBuild stepYour Claude Code setup

Make a design system skill

Turn your design system file into a skill that Claude Code uses whenever it builds or changes a screen. Test it by asking for a new screen in a fresh session.

Done when

Add a second skill for whatever you correct most often.

Keep these

  • A skill is a folder of instructions and files.
  • It loads only when a task matches.
  • Use it for methods, CLAUDE.md for rules.