Key takeaways
- Claude Skills are JSON files containing instructions, examples, and metadata that customize Claude’s behavior for specific tasks—no coding required.
- The JSON structure includes five main fields: name, description, instructions, examples, and version, with a 32,000-character limit on instructions.
- Skills are best for repetitive tasks (emails, data extraction, content templates), while saved prompts suit occasional use and MCP servers handle live external tool connections.
- Skills are available only on Claude Pro and Team plans ($20/month), with a limit of 100 custom skills per account and 200 KB per file.
- You can share skills by sending the JSON file to others, who can upload it to their own accounts—there is no built-in marketplace as of September 2026.
To create a Claude skill, you write a JSON file that contains instructions, examples, and metadata telling Claude how to behave for a specific task. You save this as a .json file, upload it to your Claude account through the Skills interface (in Claude Pro or Team plans), and then select that skill when you need Claude to follow those particular instructions—like formatting customer emails in your brand voice or extracting data into a standard spreadsheet layout.
How Claude Skills Work: The Recipe Card Analogy
Think of a Claude Skill as a recipe card you hand to a cook. Without the card, the cook knows general cooking techniques but makes decisions on the fly. With your recipe card, they follow your exact measurements, timing, and plating style every time. The skill file is that recipe: it tells Claude your preferred tone, output format, edge cases to watch for, and examples of good results. When you activate the skill, Claude reads those instructions before responding to your message.
The file itself is JSON—a structured text format that pairs labels with values. You do not need to write code. You fill in fields like "name", "description", and "instructions" inside curly braces and quotation marks. Claude reads the structure, not programming logic.
Key Numbers for Claude Skills
| Limit or cost | Figure |
|---|---|
| Maximum instruction length | 32,000 characters |
| Skills per account (Pro) | 100 custom skills |
| File size limit | 200 KB per skill |
| Cost to use (Pro plan) | $20/month (includes skills) |
| Cost to use (Free plan) | Not available |
These limits apply as of September 2026. The 32,000-character instruction cap is roughly 5,000 words—enough for detailed guidelines and a dozen examples.
The JSON Structure: What Goes in a Skill File
A Claude Skill file contains five main fields. Here is a minimal example for a customer service email formatter:
{
"name": "Customer Service Email Formatter",
"description": "Rewrites support responses in friendly, concise language with our standard sign-off",
"instructions": "Rewrite the user's draft email to be warm but professional. Keep it under 150 words. Always end with 'Thanks for choosing us!' followed by the sender's first name. Avoid jargon. If the customer reported a bug, acknowledge the inconvenience in the first sentence.",
"examples": [
{
"input": "tell customer we fixed the login issue",
"output": "Hi there,\n\nWe've fixed the login issue you reported. You should be able to sign in now without any trouble. Sorry for the inconvenience!\n\nThanks for choosing us!\nAlex"
}
],
"version": "1.0"
}
The name field is what you see in the skills dropdown. The description helps you remember what the skill does when you have dozens saved. The instructions field is where you write the rules—tone, length, formatting, edge cases. The examples array shows Claude input-output pairs; two to five examples usually work well. The version field is optional but useful when you iterate.
For a small business invoice data extractor, the instructions might specify: “Extract client name, invoice number, date, line items, and total from the user’s message. Output as a tab-separated row ready to paste into a spreadsheet. If any field is missing, write MISSING in that column.” Your examples would show a messy email and the clean TSV output.
What Not to Put in the Instructions
Do not embed your entire product catalog or a 10-page style guide. Skills work best with principles and patterns, not exhaustive lists. If you need Claude to reference a large document, upload that document in the conversation instead and let the skill describe how to use it.
Common Misconception: Skills Are Not Permanent Memory
Many users assume a skill teaches Claude new facts that persist across all conversations. It does not. A skill is active only when you select it for a specific chat. If you create a skill called “Company FAQ” with 50 answers, Claude will follow the instructions in that skill file—like “always check this FAQ list before answering”—but only while the skill is turned on. Start a new conversation without selecting that skill, and Claude will not remember your FAQ. Skills shape behavior and format; they are not a knowledge base you upload once and forget.
When to Use a Skill vs. a Saved Prompt vs. an MCP Server
| Tool | Best for | Setup effort | Reusability |
|---|---|---|---|
| Claude Skill | Repeated tasks with consistent format/tone (emails, data extraction, content templates) | Low—write JSON, upload | High—select from dropdown anytime |
| Saved Prompt | One-off complex requests you use occasionally (quarterly report outline, niche analysis) | Very low—copy-paste text | Medium—stored in notes, manual paste |
| MCP Server | Connecting Claude to live external tools (your CRM, a database, an API you control) | High—requires server setup, authentication | High—runs automatically when needed |
Use a skill when you do the same type of task five times a week. Use a saved prompt when you need the instruction twice a quarter. Use an MCP server when Claude needs to fetch or update data in another system in real time. For a solopreneur writing weekly newsletters, a skill makes sense. For an annual tax document review, a saved prompt is enough.
How to Save and Use Your Skill
Write your JSON in any text editor—Notepad on Windows, TextEdit on Mac set to plain text mode, or an online JSON validator to catch syntax errors. Save the file with a .json extension. In Claude, go to Settings → Skills (this option appears only on Pro or Team plans). Click “Upload Skill” and select your file. Claude validates the structure and adds it to your library.
To use the skill, start a conversation and click the skills icon (a small toolbox or grid, depending on interface version). Select your skill from the list. Claude will apply those instructions to every message in that conversation until you deselect the skill or start a new chat.
You can edit a skill by downloading the JSON, changing the instructions, and re-uploading with the same name—Claude will overwrite the old version.
Practical Examples for Small Business
Social media caption writer: Instructions specify character limits, required hashtags, brand voice (playful vs. authoritative), and whether to include emojis. Examples show a product description turning into an Instagram caption and a blog link turning into a LinkedIn post.
Meeting notes to action items: Instructions say “Extract action items as a numbered list. Each item must have an owner and a due date. If no due date is mentioned, write ‘TBD’.” Examples show a rambling transcript and the clean output.
Product description formatter: Instructions define a three-paragraph structure (hook, features, call-to-action), word count (under 120 words), and required elements (price, stock status, return policy mention). Examples show raw product specs and the final web copy.
What Makes a Skill Effective
Specificity beats generality. “Be professional” is vague; “Use contractions, avoid exclamation marks, address the customer by first name if provided” is actionable. Include two edge cases in your instructions: what to do when information is missing and how to handle ambiguous input. If your skill formats addresses, specify how to handle international addresses or PO boxes.
Test your skill with bad input—typos, incomplete data, unexpected requests. If Claude outputs garbage, add an instruction like “If the input does not contain the required fields, reply ‘I need the following information to proceed: [list]’ instead of guessing.”
Limitations Worth Knowing
Skills do not carry over between devices unless you sync them through your account. They do not work in the API (as of September 2026)—they are a feature of the web and mobile interfaces only. You cannot schedule a skill to run automatically; you must manually select it each time. And skills do not override Claude’s safety guidelines—asking a skill to output harmful content will still be refused.
Frequently Asked Questions
What are Claude Skills and what can they do?
Claude Skills are custom instruction sets you upload to guide Claude’s behavior for specific tasks. They can enforce a tone, output format, or workflow—like rewriting emails in your brand voice, extracting data into spreadsheet rows, or generating social media captions with required hashtags. They work best for repetitive tasks where you want consistent results without retyping instructions each time.
Do I need coding experience to create Claude Skills?
No. You write instructions in plain English inside a JSON file, which is just a text format with labels and values in curly braces. You fill in fields like "instructions" and "examples" the same way you would fill in a form. Free online JSON validators will catch syntax errors like missing commas. If you can write an email, you can write a skill.
What file format do Claude Skills use?
Claude Skills use JSON (.json file extension). JSON is a plain-text format that pairs labels with values using quotation marks, colons, and curly braces. You write it in any text editor—Notepad, TextEdit in plain-text mode, or VS Code. The file must be valid JSON or Claude will reject it at upload, but online validators make this easy to check.
Where can I save my custom Claude Skills?
You upload skills directly to your Claude account through Settings → Skills (available on Pro and Team plans only). Claude stores them in your account, and they sync across devices where you are logged in. You can also keep local backup copies of the JSON files on your computer. Skills do not expire, but you are limited to 100 custom skills per account.
Can I share my Claude Skills with others?
Yes, by sharing the JSON file. Send the .json file to a colleague, and they can upload it to their own Claude account. The skill will work identically for them. There is no built-in marketplace or public library as of September 2026, so sharing happens file-by-file. Some users post skills on GitHub or community forums for others to download.
Photo by Christina Morillo on Pexels