← All writing

Claude skills explained: make one and share it

A Claude skill is a folder of instructions Claude loads when a task needs it. What goes in one, when to make one, and how to share it so others can use it.

By Branislav · · 3 min read

Short answer: a Claude skill is a small folder that teaches Claude how to do one job your way. At its heart is a file called SKILL.md: a name, a one line description of when to use it, and the instructions. Claude reads the description, and when a task matches, it loads the rest. You make one when you notice yourself pasting the same long prompt again and again.

What is inside a skill?

The minimum is one Markdown file with a short header and the instructions below it:

---
name: landing-page-review
description: Review a landing page for clarity, trust and conversion. Use when the user shares a landing page URL, screenshot or copy and asks for feedback.
---

# Landing page review

1. Read the page as a first time visitor.
2. Say in one sentence what the product does. If you cannot, that is finding one.
3. Check the headline, the first button, proof, and pricing, in that order.
4. Give the three changes with the biggest impact first.

A skill can also carry supporting files: examples, checklists, templates, or small scripts Claude can run. The description matters most, because it decides when the skill gets used.

How is a skill different from a prompt?

A prompt is something you paste every time. A skill is something Claude keeps and reaches for on its own when the task fits. Prompts are great for one off work. Skills are for processes you repeat: reviewing code your way, writing in your brand voice, preparing a weekly report.

If you already have a prompt you trust, you are most of the way to a skill. Read how to write prompts that work first, then wrap the best one in a SKILL.md.

When should you make a skill?

  • You have pasted the same instructions three times.
  • The job has steps that must happen in order.
  • You want the same result every time, from you or your team.
  • The job needs reference material, like a style guide or a checklist.

Skip it for tasks that are different every time. A skill for "write anything" is just a vague prompt in a folder.

How do you share a skill?

A skill is just files, so sharing is easy: zip the folder, or share the single SKILL.md. Whoever receives it adds it to their own Claude setup.

On AfterPrompt you can attach a skill file to any post. Show the result it produced, say what it is for and what did not work, and anyone can download it straight from the post. It is the fastest way to find out whether your skill works for other people too.

Frequently asked questions

Do I need to code to make a Claude skill?

No. A skill can be a single Markdown file of plain instructions. Scripts are optional and only needed for jobs that require running code.

What makes a good skill description?

Say what the skill does and when to use it, in one or two sentences. Claude uses it to decide when to load the skill, so be specific.

Can I share a skill with my team?

Yes. A skill is a folder of files, so you can share it as a zip or a single SKILL.md, or post it on AfterPrompt for anyone to download.

Is a skill the same as a custom GPT?

They solve a similar problem, saving instructions so you don't repeat them, but a Claude skill is a portable folder of files rather than a hosted chatbot.

Keep reading

Join the conversation.

Indie hackers, solo founders and AI enthusiasts, all in one feed. Follow them, ask them anything, share what you find. Free, two minutes.

Make your profile