How to Write a Claude Skill (Step by Step)
By PromptLLM · Published 14 November 2026 · 6 min read
To write a Claude Skill, create a folder with a SKILL.md file. Give it a name and a specific description of when to use it, then write the method as short numbered steps. Test it on real tasks and tighten the wording wherever the output misses. A first skill takes about 20 minutes.
In this guide
Step 1: Choose a repeatable task
Pick something you do at least weekly and already know how to do well. If you cannot describe how you would do it, Claude cannot follow your method. Good first picks: a report format, a meeting summary, an email reply style.
Step 2: Write the name and description
The description decides when Claude uses your skill, so make it specific. Say what the skill does and when to use it. Compare "Helps with writing" (too vague, will trigger randomly or never) with "Rewrite product descriptions to under 80 words in our brand voice. Use when the user pastes a product description."
Step 3: Write the method as short steps
Write as if briefing a smart new colleague. Numbered steps work better than paragraphs. Include the output format you want, and say explicitly what Claude should not do, such as inventing numbers or names.
SKILL.md
---
name: product-description
description: Rewrite product descriptions to under 80 words in our brand voice. Use when the user pastes a product description.
---
# Product description
1. Keep every factual detail; add none.
2. Lead with the benefit, then the feature.
3. Maximum 80 words. No exclamation marks.
4. Return the rewrite, then one line noting anything you were unsure about.Step 4: Add helper files only if needed
If your method needs a long style guide, a template or a worked example, put it in a separate file in the same folder and mention it from SKILL.md. Claude then reads it only when relevant. Keep SKILL.md itself focused.
Step 5: Install it
How you install a skill depends on where you use Claude. In Claude Code, skills live in a skills folder in your project or home directory. In the Claude apps, you can upload a skill as a zip file in settings where your plan supports it. Anthropic updates these details, so check the current documentation for exact steps.
Step 6: Test on real tasks and revise
Run it on three real examples, including one awkward one. Whenever the output misses, fix the instruction that should have prevented it, rather than adding more rules. Shorter, clearer instructions usually beat longer ones.
- Skill never triggers: make the description more specific about when to use it.
- Skill triggers at the wrong time: narrow the description.
- Output format drifts: add an explicit example of the output.
- Claude invents details: add a rule such as "If information is missing, say so."
Want ready-made skills and prompts?
The PromptLLM directory has 3,400+ prompts and Claude Skills you can browse by category. Get the free Claude Skills guide, or unlock the full directory.