What Are Claude Skills?
Understanding the Concept
Modular Instruction Sets
Skills are self-contained modules that package instructions, workflows, and resources together. Think of them as teaching Claude a specialized task once, then reusing that knowledge whenever needed.
Reusable Workflows
Once created, a Skill can be applied across multiple conversations and projects. Create a report generator once, use it for quarterly reports, monthly summaries, or any data analysis task.
Automatic Activation
Claude automatically identifies and loads relevant Skills based on your request context. No manual selection needed. Just ask, and Claude matches your task to available Skills.
| Aspect | CLAUDE.md / AGENTS.md | Skill |
|---|---|---|
| Scope | One project | Any project |
| Trigger | Automatic in directory | Task-based (description matching) |
| Portability | Tied to repo | Shareable package |
| Contents | Instructions only | Instructions + scripts + assets |
| Version control | With your code | Separate distribution |
| Use case | "How we do things here" | "How to do this type of task" |
Creating a Custom Skill
Two Approaches
Manual Creation
Build your Skill from scratch using a text editor. Create the folder structure, write the
SKILL.md file with YAML frontmatter, add instructions, and include any supporting
resources.
Claude Web Wizard
Use Claude's guided creation interface at claude.ai. Claude walks you through defining the purpose, writing instructions, and generating all necessary files automatically.
--- name: Sales Report Generator description: Generates monthly sales reports in Excel format based on provided data --- # Sales Report Generator ## Instructions 1. Receive raw sales data in CSV format 2. Process the data to calculate total sales, average sales, and growth 3. Generate an Excel report with charts and summaries 4. Format according to company branding guidelines ## Examples ### Input CSV file containing: date, product, quantity, revenue ### Output Excel report titled "Monthly Sales Report" including: - Summary dashboard - Revenue breakdown by product - Trend charts - YoY comparison
YAML Frontmatter
The name field (max 64 chars) identifies your Skill. The description
field (max 200 chars) tells Claude when to use it. This description is crucial for activation.
Instructions & Examples
Clear, step-by-step instructions guide Claude's execution. Concrete examples demonstrate expected inputs and outputs. Both are essential for consistent Skill behavior.
Folder Structure
Organizing Your Skill
SKILL.md
The core file containing metadata and instructions. Claude reads this first to understand the Skill's purpose and how to execute it.
Templates
Pre-formatted documents, spreadsheets, or presentation templates. Claude uses these as starting points for generated output.
Scripts & Resources
Executable code for data processing and reference materials like style guides. Claude can invoke scripts and consult resources during execution.
# Compress your skill folder into a ZIP file zip -r my-skill.zip my-skill/ # The ZIP should contain your skill folder as root: my-skill.zip └── my-skill/ ├── SKILL.md └── ... # Upload via: Settings → Capabilities → Skills → Upload skill
How Claude Uses Skills
Progressive Loading System
Lazy Loading
Claude doesn't load all Skills into memory. It only reads the full instructions and resources when a Skill's description matches the current task, keeping responses fast and efficient.
Resource On-Demand
Templates, scripts, and reference files are loaded only when the instructions require them. This progressive approach minimizes overhead while maximizing capability.
Skill Activation Logic
How Claude Decides
Description Matching
The description field is the primary activation trigger. Claude compares your
request against all Skill descriptions to find the best match. Write descriptions that clearly
state what the Skill does and when to use it.
Task Relevance
Claude assesses whether the Skill's purpose aligns with what you're asking. A presentation Skill won't activate for data analysis requests, even if keywords partially match.
Contextual Cues
The full conversation context influences activation. If you've been discussing quarterly reports, Claude is more likely to activate report-related Skills even for ambiguous requests.
Enabled Status
Skills must be toggled ON in Settings to be considered. Disabled Skills are invisible to the activation system. Use this to temporarily disable Skills without deleting them.
Specificity Wins
When multiple Skills could match, Claude prefers the more specific one. A "Q3 Financial Report" Skill beats a generic "Report Generator" for quarterly finance requests.
Multi-Skill Chaining
Complex tasks may activate multiple Skills sequentially. Claude can use a data processing Skill, then a visualization Skill, chaining them together automatically.
Best Practices & Tips
Optimize Your Skills
Write Precise Descriptions
Your description (max 200 chars) is the most important field. Be specific about what the Skill does and when it should activate. Vague descriptions lead to missed or incorrect activations.
Include Concrete Examples
Examples in your SKILL.md show Claude exactly what you expect. Include input/output pairs, edge cases, and formatting requirements. More examples mean more consistent results.
Keep Instructions Step-by-Step
Break complex workflows into numbered steps. Claude follows sequential instructions better than paragraph-form descriptions. Each step should be a single, clear action.
Test with Edge Cases
After creating a Skill, test it with unusual inputs and ambiguous requests. Refine the description and instructions based on where Claude makes mistakes or misinterprets intent.
Claude Web at claude.ai can create Skills directly for you through a guided wizard. Just describe what you want the Skill to do, and Claude will generate the SKILL.md file, suggest folder structure, and even help write examples. It's the fastest way to get started.
Start by identifying a repeatable task in your workflow. Create a SKILL.md with a clear description and step-by-step instructions. Upload it to Claude and watch your custom workflow activate automatically.