PPromptLLM
Prompt DirectoryGuidesFree Resources
Get access
Sign in
Prompt DirectoryGuidesFree Resources
PPromptLLM
Prompt DirectoryGuidesFree ResourcesSign inSubscribePrivacyTerms

© 2026 PromptLLM, a trading name of Properly Ads Ltd

Guides / How to Write a Claude Skill (Step by Step)

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

  1. Step 1: Choose a repeatable task
  2. Step 2: Write the name and description
  3. Step 3: Write the method as short steps
  4. Step 4: Add helper files only if needed
  5. Step 5: Install it
  6. Step 6: Test on real tasks and revise

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.

Unlock the directory
Browse Claude Skills Free Claude Skills guide

Keep reading

  • What Are Claude Skills? A Plain-English Guide
  • Claude Skills Examples: 6 Ideas by Job