Ajitha.
Back to Blog
ClaudeAITutorialSkills

Adding Custom Skills to Claude: A Simple Guide

2026-02-094 min read

Introduction

Claude skills are like instruction manuals that help Claude do specific tasks really well. Think of them as pre-packaged expertise that you can add to Claude to make it better at creating documents, spreadsheets, presentations, or any other specialized task. In this blog post, we'll cover how to create and add your own custom skills so Claude can handle your specific workflows exactly the way you want.

We'll cover:

  • What skills are and how they work
  • Creating your first skill
  • Skill file structure
  • Testing and refining

What are Claude Skills?

Skills are essentially folders containing best practices and instructions for specific tasks. For example, there's a docx skill for creating professional Word documents, a pptx skill for building presentations, and an xlsx skill for working with spreadsheets.

When you ask Claude to create a PowerPoint presentation, Claude automatically reads the pptx skill documentation first, then follows those guidelines to produce a high-quality result. You can create your own custom skills for any repetitive task you need Claude to handle.

Prerequisites

To create and use custom skills, you need:

  • Access to Claude (via claude.ai or the API)
  • A text editor for creating skill files
  • Basic understanding of how Claude works

Note: Custom skills are currently available in Claude's computer use mode.

Skill File Structure

Every skill lives in a folder with this basic structure:

/mnt/skills/user/my-skill/
├── SKILL.md          # Main instruction file
└── examples/         # (Optional) Example files

The SKILL.md file is where all the magic happens. This is where you write instructions that Claude will read before performing your task.

Creating Your First Skill

Let's create a simple skill that helps Claude write email newsletters in your company's style.

Create the skill folder and SKILL.md file

Create a new folder in /mnt/skills/user/ with a descriptive name and add your instructions. The SKILL.md content looks like below:

# Newsletter Skill

## Purpose
This skill helps create company newsletters following our brand guidelines.

## When to use this skill
Use this skill whenever the user asks to:
- Write a newsletter
- Create an email announcement
- Draft a company update

## Guidelines

### Tone and Style
- Keep it friendly and conversational
- Use short paragraphs (2-3 sentences max)
- Write in active voice

### Structure
Every newsletter should follow this format:
1. Catchy subject line
2. Opening greeting
3. Main content (3-5 sections)
4. Call to action
5. Sign-off

### Example Format
Subject: [Exciting news/Update/etc.] 🎉

Hi team,

[Opening paragraph with main announcement]

**Section 1: [Topic]**
[2-3 sentences about this topic]

[Call to action]

Best,
[Signature]

Test your skill

Now ask Claude to create a newsletter. See the example below:

"Can you write a newsletter announcing our new product launch?"

Claude will automatically:

  1. Detect that you want a newsletter
  2. Read your /mnt/skills/user/newsletter/SKILL.md file
  3. Follow the guidelines you specified
  4. Create the newsletter in your exact format

Best Practices

Here are some tips I've learned from building custom skills:

Be specific: Vague instructions like "make it good" don't help. Instead write "use bullet points for lists, keep paragraphs under 3 sentences, include exactly one emoji per section."

Include examples: Claude learns best from seeing actual examples of what you want vs. what you don't want.

Test iteratively: Start with basic instructions, test them, then refine based on Claude's output.

Use clear triggers: In the skill description, specify exactly when Claude should use this skill (keywords, phrases, or task types).

Sample Skill: Meeting Notes

Here's a complete example of a skill for formatting meeting notes:

# Meeting Notes Skill

## When to Use
- User asks to "format meeting notes"
- User provides raw notes to organize

## Format

Meeting: [Topic]
Date: [Date]
Attendees: [Names]

### Key Decisions
- [Decision 1]
- [Decision 2]

### Action Items
- [ ] [Task] - @[Owner] - Due: [Date]

### Discussion Points
- [Key point from topic 1]
- [Key point from topic 2]

### Next Steps
[What happens next]

## Guidelines
- Keep action items specific and assigned
- Only include decisions that were finalized
- Summarize discussions, don't transcribe

Conclusion

Creating custom skills is straightforward once you understand the basic structure. Start with simple instructions, test them out, and gradually refine based on the results you're getting. The key is being specific about what you want Claude to do.

Custom skills can save you tons of time on repetitive tasks and ensure consistent quality across your work. For more details on Claude's skill system, check out the official documentation. Thanks for reading!