How to Make Your First Claude Skill (SKILL.md), With a Ready Example
A Skill is a folder with one text file that teaches Claude a job you do again and again. How to write one, where to put it in Claude Code and the Claude app, and a Hinglish reel-script Skill you can copy.
यह लेख हिंदी में पढ़ेंHow to Make Your First Claude Skill (SKILL.md), With a Ready Example
If you keep pasting the same long instructions into Claude, like how you want your reel scripts written, how your GST invoices should be checked, or what your company's report format is, a Skill is the fix. You write those instructions once, in a file, and Claude uses them by itself whenever the job comes up.
This guide walks through making one from scratch. You don't need to know how to code for the basic version.
What a Skill is
A Skill is a folder with a file called SKILL.md inside it. The file has two short fields at the top, a name and a description, and then plain instructions written in Markdown. You can also put scripts, templates or reference files in the same folder, but the SKILL.md file is the only thing that has to be there.
The clever part is how Claude reads it. At the start of a chat Claude only loads the name and description of each Skill, about 100 tokens each, so having many Skills installed costs almost nothing. When your request matches a description, Claude reads the full instructions. Extra files in the folder are opened only if the instructions point to them. Anthropic calls this progressive disclosure.
Skills started at Anthropic and are now an open standard published at agentskills.io, so the same folder can work in other AI tools that support the standard, not only Claude.
Step 1: write the description first
The description decides whether your Skill ever gets used, because it is the only part Claude sees before deciding. Anthropic's advice is to say two things in it: what the Skill does, and when to use it. Write it in the third person.
- Weak:
Helps with reels. - Better:
Writes 30-45 second Instagram reel scripts in Hinglish for small Indian businesses. Use when the user asks for a reel, short or video script for a shop, product or offer.
The second one names the task, the language, the audience and the words a user is likely to type. That is what makes Claude pick it up at the right time.
Step 2: follow the naming rules
- name: up to 64 characters, only lowercase letters, numbers and hyphens. It can't contain the words 'anthropic' or 'claude'. Example:
hinglish-reel-script. - description: up to 1,024 characters, and not empty.
- Folder name: make it the same as the name.
Step 3: write the instructions
Below the two fields, write the instructions the way you would brief a new assistant. Keep it short and specific. Anthropic suggests keeping the main file under about 500 lines, and moving long reference material into separate files that the main file links to. Things that help:
- What to ask the user before starting, if information is missing
- The steps, in order
- The exact output format (a table, a list, a file type)
- What not to do
Here is a complete Skill you can copy. It writes reel scripts for local shops in Hinglish:
---
name: hinglish-reel-script
description: Writes 30-45 second Instagram reel scripts in Hinglish for small Indian businesses. Use when the user asks for a reel, short or video script for a shop, product or offer.
---
# Hinglish reel script
## What to ask first
If the user has not said these, ask in one message:
- What the business sells and in which city
- The one offer or message for this reel
- Who it is for (students, families, office-goers...)
## How to write it
1. First line is the hook, under 8 words, said on screen in the first 2 seconds.
2. Then 3 short beats: problem, what the shop offers, proof (price, review, photo).
3. End with one action: "DM karo", "aaj hi aao", or the shop's location.
4. Hinglish in Roman script. Short sentences. No English words a shopkeeper would not say.
## Output format
A table with three columns: Time | On screen | Voiceover.
Then 5 hashtags, local ones first.
## Don't
- Don't promise discounts the user did not mention.
- Don't use "best in town" or other claims nobody can check.Step 4: install it
In Claude Code: save the folder in one of two places. ~/.claude/skills/hinglish-reel-script/SKILL.md makes it available in every project on your computer. .claude/skills/hinglish-reel-script/SKILL.md inside a project makes it part of that project, and if you commit it to git, your whole team gets it. Claude Code notices new and edited Skills without a restart.
In the Claude app (claude.ai): zip the folder so that the folder itself is at the top of the zip (hinglish-reel-script.zip containing hinglish-reel-script/SKILL.md). Then go to Customize, then Skills, click +, choose Create skill and then Upload a skill. Skills need code execution, so turn on 'Code execution and file creation' (in newer layouts, 'Create and edit files') under Settings, then Capabilities. Anthropic's help pages list Skills on paid plans; one page also lists Free, so check your own Customize page.
One thing that surprises people: a Skill uploaded to the Claude app is not automatically available in the API, and a Skill added through the API doesn't show up in the app. Each place has its own list.
Step 5: test it
Start a new chat and ask for the job in normal words, without mentioning the Skill: 'Meri mithai ki dukaan ke liye Diwali offer ka reel script likho, Jaipur me hai'. If Claude follows your format, it worked. If it ignores the Skill, the description is usually the problem. Add the words people actually type, like 'reel', 'short' and 'video script', and try again.
Be careful with Skills from other people
A Skill can include scripts that run on your machine. Anthropic's docs warn that a malicious Skill could leak data or reach systems it shouldn't, and say to use Skills only from sources you trust. Before installing one from GitHub or a forum, open every file in the folder and read it. If it tells Claude to send data to a website you don't recognise, don't install it.
Ideas for your first Skills
- Your blog or YouTube channel's writing style, with words to avoid
- Checking a GST invoice for missing fields before you send it
- Turning meeting notes into a task list in your team's format
- Your college's practical-file format for lab reports
- Replying to customer WhatsApp messages in your shop's tone
If you'd rather have Claude write the first draft of a Skill for you, our prompt library has a ready prompt for that.
Sources
Frequently asked questions
What is a Claude Skill?
A folder with a SKILL.md file that holds a name, a description and instructions for a task. Claude loads the instructions on its own when your request matches the description.
Do I need to know coding to make a Skill?
No. A basic Skill is just a text file in Markdown. Scripts are optional and only needed if you want the Skill to run code.
Where do I save a Skill for Claude Code?
In ~/.claude/skills/<skill-name>/SKILL.md for all your projects, or .claude/skills/<skill-name>/SKILL.md inside one project.
Why is Claude not using my Skill?
Usually the description is too vague. Say what the Skill does and when to use it, using the words people actually type for that task.
Are Skills safe to download?
Only from sources you trust. A Skill can include scripts, so read every file in the folder before installing it.
Save this summary as an image or share it.
AICreatorHub Team
The AICreatorHub editorial team is a group of hands-on AI practitioners, writers and developers based in India. We test AI tools and models ourselves, track official releases from OpenAI, Anthropic, Google, Meta and xAI, and translate them into simple, India-first guides in English and Hindi. Every article is written for real Indian use cases — pricing in rupees, free-tier tips and practical, tested steps — so you get accurate, up-to-date and genuinely useful AI information.