Claude Skills: what they are, where they come from, how to build one
Zaheer Merali · MWC · May 5, 2026
A skill is a markdown file. That’s it.
Before we start — enable Skills
Settings → Capabilities
Code execution and file creation
Customize → Skills
skill-creator — toggle it on
A skill is a recipe Claude follows every time.
Instead of re-explaining how you like things done, you write it once. Claude reads it before every relevant task and follows it consistently — across every conversation, every session, every surface.
The key rule: every skill needs a WHAT (what it does) and a WHEN (when to use it). That’s how Claude knows to reach for it.
Skill folder structure
your-skill-name/
SKILL.mdrequired
scripts/optional
references/optional
assets/optional
Skills don’t come
from Claude.
They come from you.
A skill is implicit knowledge made explicit.
The best ones come from people who already know
how to do something well.
We’re going to take something one of you knows how to do
— and build a skill from it. Live.
Your expertise is the raw material.
Think of something you do well that’s hard to explain.
Not the outcome. The how.
Open Claude. Start extracting.
Ask it to turn the conversation into a skill when you’re ready.
The session is the space.
Try this. Dictate or type it into Claude:
“I give feedback on [thing] pretty often. Usually the things I find myself saying over and over are [describe the patterns]. Can you build a skill where I input the thing I’m reviewing, and you write a first draft of the feedback you think I’d give, as close to my voice as you can?”
Where: uploaded as a file inside each Project
Central store: no — per-project, manually managed
Update: delete old file, upload new version
Share: Team/Enterprise plans only
Where: Customize → Skills in the sidebar
Central store: yes — one place, all your skills
Update: edit the skill directly in Customize
Share: org-wide via Team/Enterprise admin
Where: ~/.claude/skills/ on your machine
Central store: yes — available across all projects
Update: edit the file — changes apply instantly
Share: commit to repo for team access
zaheermerali.com · meaningfulworkcollective.com · MWC AI Playground