April 6, 2026

How to Create Skills in Claude

If you’ve been using Claude for a while now, you’ve likely run into this scenario:

You ask Claude to do something. It works great. You try again the next day, and the result is slightly different. Or it skips half the instructions entirely.

This is a common frustration people hit when they try to use AI for real work. The tool is powerful, but it's inconsistent. And inconsistency kills any workflow you're trying to build.

That's one of the problems Claude Skills are designed to solve.

What is a Claude skill?

A skill is a reusable instruction set for Claude, written in a markdown file. 

An example of a Claude skill

Think of it as a how-to manual that tells Claude exactly how to perform a specific task. Instead of rewriting a detailed prompt every time you need something done, you package those instructions into a skill that Claude can reference on demand.

Skills can include step-by-step processes, formatting rules, examples of good output, and even supporting code. 

Once a skill is saved, Claude loads a short description of it at the start of every session to check whether it's relevant. If it is, Claude pulls in the full file. If not, it ignores it.

This is an important design choice. Because Claude only reads the description unless it needs the full skill, you can add dozens of skills without bloating your context window or slowing anything down. Each one stays lightweight until it's actually called.

Why skills matter more than better prompts

Most people try to solve the consistency problem by writing longer, more detailed prompts. That works up to a point, but it creates its own issues. You end up copying and pasting the same wall of text into every conversation. You forget a section, or tweak something slightly, and the output drifts. Over time, your "master prompt" becomes a mess of revisions that nobody wants to maintain.

Skills solve this by separating the instructions from the conversation. The instructions live in a file. The conversation stays focused on the task at hand. You type a short request, Claude identifies the right skill, and the work gets done the same way every time.

This is closer to how real workflows should operate. You don't explain the entire process to a colleague every time you ask them to do something. You train them once, and after that, a short request is enough. Skills give Claude that same kind of training.

Where to start: picking the right task

Skills aren't meant to automate an entire workflow end-to-end. They work best when you break a larger process into small, precise, repeatable tasks.

A good candidate for a skill is any task where you find yourself writing the same instructions over and over, where the output needs to follow a consistent format, and where you can clearly define what "good" looks like. 

For instance, formatting YouTube chapters from a transcript is a good example. So is reviewing code against a style guide, generating metadata for a blog post, or writing a status update in a specific structure.

If you're not sure which parts of your workflow would benefit from a skill, start a separate Claude conversation and talk through your process.

Describe what you do step by step, and ask Claude to help you identify which steps are repetitive and well-defined enough to turn into skills. This is a common and effective pattern: one conversation to plan, another to build.

How to create a skill

Open Claude and click the customize button (the toolbox icon) in the left sidebar. 

Clicking "customize" to access Claude skills and connections

Select "Skills," and you'll see a library of example skills that come preloaded. 

Selecting skills from the "Customize" menu

There's an MCP builder, an internal communications skill, and several others you can use as reference.

The one that matters most is the skill-creator skill. It's a skill for building skills.

Click the plus button and select "Create with Claude." 

Creating a new skill with Claude

This generates a prefilled prompt that invokes the skill-creator and asks Claude to walk you through building a new skill from scratch.

Using a pre-filled prompt to start creating a skill

Hit send, and Claude will ask you what you want to build. 

Claude will build your skill with you through a conversation

Describe the task in plain language. Be specific about the inputs, the outputs, and any formatting rules that matter. If you have examples of good output, attach them. Reference files go a long way toward helping Claude understand exactly what you're after.

Here's an example of a prompt you might use:

I want Claude to read an uploaded video transcript and create chapters formatted for YouTube (e.g., 00:00 - Intro). The skill should use the timestamps within the transcript to determine the corresponding timestamps for each chapter. Each chapter title should be brief and descriptive, about 5 words or less. The first chapter should always include "Intro" but can also include a brief description.

Our prompt for creating a simple YouTube chapter skill

Along with a prompt like this, you'd attach a sample transcript and a sample set of chapters so Claude can see the target format.

PRO TIP: Alternatively, you can open up another Claude conversation and ask it to write your prompt for you. It may feel lazy, but the fact is that AI is often much better at writing prompts than we are!

The back-and-forth

After you send your initial prompt, Claude will likely have follow-up questions. For instance, it might ask about edge cases, formatting preferences, or how to handle ambiguity. Answer these questions specifically. The more precise you are here, the better the skill will perform later.

Once Claude has enough information, it generates a finished skill file. 

Claude skills begin with a simple description

You'll see it appear as a markdown document with a description at the top (which Claude uses to decide when to activate the skill), a set of rules, a step-by-step process, an example of the expected output, and any additional notes.

Claude skills include detailed, step-by-step instructions

Claude skills include examples for reference

Saving your skill

To save the skill to Claude, click on “Copy to your skills” in the top right. 

Click "copy to your skills" to save your skill

Testing and using your skill

Once you’ve saved your skill, give it a test. Upload a real file or enter a real prompt and ask Claude to run the skill. You can invoke it directly by typing /skill-name, or simply describe the action that the skill covers. 

Invoke a skill by referencing it

As it’s processing your prompt, you should see Claude accessing the relevant skill before it prepares its response.

Claude accesses your skill before it answers

Once you get an answer, check the output against what you'd expect. In our test, Claude provided chapters exactly the way we wanted.

Claude's output should match your skill instructions

If your result isn't quite right, tell Claude what to adjust. Describe the problem, ask for a fix, and test again. This loop of testing and refining is where the real quality comes from. Most skills need two or three rounds before they're solid.

Going deeper with Cowork

For simple skills that don't require code execution, building and testing through the browser works fine. But if you want more thorough testing, the Cowork tab in the Claude desktop app is worth using.

Claude cowork extends Claude's functionality

Cowork gives Claude an improved ability to write and execute code as part of its testing process. When you ask it to evaluate a skill, it doesn't just check whether the output looks right. It can create test cases, run multiple tests with different inputs, compare the skill's output against a baseline, and summarize the results in a structured report.

Claude cowork conducts thorough, programmatic tests

In one test, Claude reviewed the skill, generated test cases, ran comparisons between baseline Claude and the skill-enhanced version, and produced an HTML report with benchmarks. This is programmatic evaluation, not just an LLM guessing whether its own output is good.

Claude cowork creates an HTML page documenting results

The tradeoff is time. Cowork tasks can take significantly longer to process, sometimes ten minutes or more for a thorough evaluation. But you can work on other things while it runs, and the quality of the feedback is substantially better.

The bigger picture

Skills represent a shift in how you should think about working with AI. Instead of treating every conversation as a blank slate, you're building a library of reliable, tested processes that Claude can execute on command. Each skill you create removes one more repetitive task from your plate.

This is what it looks like to stop doing your job manually and start orchestrating your tools instead. You don't write YouTube chapters by hand. You don't reformat transcripts from scratch. You don't rewrite the same prompt for the hundredth time. You build the skill once, test it until it's right, and let Claude handle it from there.

The best part is that you build these skills through conversation. No coding required, no complex setup. Just describe what you want, refine it with Claude, and save it.

If you're looking to take this further and build AI-powered workflows across your entire operation, that's exactly what we do at XRAY. We help teams design and implement automations using AI and the tools they already use every day. Whether it's building custom Claude skills, integrating systems, or streamlining repetitive processes, the goal is always the same: turn AI from an experiment into reliable infrastructure for your business. 

Schedule a free consultation at the top of this page to learn more. 

Related Articles

View All Articles
Tutorial
AI

How to build your first AI agent in n8n

AI agents in n8n can automate your repetitive tasks in minutes. In this tutorial, we’ll show you how to create your first AI agent.
Tutorial
News and Updates

How to Make ChatGPT Download Files, Click Buttons, and Navigate Websites

Agent Mode lets ChatGPT see and analyze images, click buttons, fill out forms, and do your work for you as it browses the web. Here's how it works.
Tutorial

How to Create an OpenAI API Key in Under 2 Minutes

Learn how to get an OpenAI API key so you can connect the latest ChatGPT models to automation tools like Zapier, Cursor, and other third-party apps.