The handbook/Skills: Beginner Guide to Claude Code
SettingsMy workspaceOfficial docs ↗

Learn one feature at a time

Save a workflow
you want to reuse.

Understand skills, find installed ones, and practice with a small review-only recipe.

STEP-BY-STEP HANDBOOKChecked September 24, 2026

What is a skill?

A skill is a reusable set of instructions and, sometimes, supporting files or scripts. It helps Claude perform a particular kind of task. A skill does not guarantee accuracy and may contain code that needs review.

Use thisWhen you need
CLAUDE.md instructionsRecurring project facts and working rules.
SkillA repeatable task with specific steps and an output.
PluginA packaged group of useful capabilities.
ConnectorAccess to information or actions in another service.

Find a skill first

In Claude, inspect Customize → Skills. Use the directory to find suitable skills and check their source. In Claude Code, type / to see what is available. A skill can be selected explicitly, and supported skills can also be used when Claude judges them relevant.

Make a review-only practice skill

In a practice repository, a skill can live at .claude/skills/explain-change/SKILL.md. Review this file before adding it:

Example file • .claude/skills/explain-change/SKILL.md
---
name: explain-change
description: Explain the current project diff for a beginner.
disable-model-invocation: true
---

Read the current diff without editing anything.
Explain the purpose of each changed file in plain language.
Separate verified behavior from assumptions.
List relevant tests and missing evidence.
Do not commit, push, deploy, or send messages.

The invocation setting makes this an explicit-use skill. Try /explain-change in a supported session and compare the response with the actual diff. If it is missing, check the file location, installed version, and skill discovery controls.

Review repository skills before running Claude

A project skill’s allowed-tools can apply when that skill is invoked even in a folder you have not trusted. Review skill frontmatter and scripts in cloned repositories before starting Claude Code there. A skill can approve more tool access than its friendly name suggests. See the security learning path.

Improve it using evidence

Try one small change and one empty diff. Did the skill invent work, skip important files, or give an unclear answer? Refine only the instruction causing that problem. Avoid adding overlapping skills for the same task. Keep actual permissions limited independently of the skill text.

References

Was this chapter useful?

Report an error

Votes are shared only if you enable optional measurement in Privacy & Preferences.

CONTINUE THE GUIDEClaude Code Settings

Edit this example

Changes here affect this copy only. Nothing runs from this site. Closing this window discards your edits.

Search the field guide

Search all chapters and FAQ answers. Use Tab to reach a result and Enter to open it.