Claude Skills explained: How to create reusable AI workflows

[00:04] Welcome back to How I AI. I'm Clara Vaux, product leader and AI obsessive here on a mission to help you build better with these new tools. Today, we have the first of many How I AI mini episodes. This week is going to be all about Claude Skills, the newly released feature from Anthropic that lets anybody create and load up Claude Code, the API or Claude.ai with specific skills that you can use. [00:30] and tools it can call on at any time. I'm going to give you a view into how to create skills, what skills are, and a couple ideas about how you can use skills in your workflows. [00:41] Let's get to it. [00:42] Today's episode is brought to you by ChatPRD. I know that many of you are tuning into How I AI to learn practical ways you can apply AI and make it easier to build. That's exactly why I built ChatPRD. [00:55] ChatPRD is an AI co-pilot that helps you write great product docs, [01:00] automate tedious coordination work and get strategic coaching from an expert AI CPO. And it's led by everyone from the fastest growing AI startups to large enterprises with hundreds of PMs. [01:11] Whether you're trying to vibe code a prototype, teach a first time PM the ropes, or scale efficiently in a large organization, [01:18] Chat PRD helps you do better work fast. And we're integrated with the tools you love: vzero.dev, Google Drive, Slack, Linear, Confluence, and more, so you don't have to change your workflow to accelerate with AI. [01:31] Try Chat PRD free at chatprd.ai slash howiai. And let's make product fun again.

[01:39] Today I'm going to be talking to you about clawed skills. What are clawed skills? How do you create them? And what would be some good uses for folks, especially [01:49] product engineers and designers out there to use Claude skills in your day-to-day workflow. [01:55] So what are CLAWD skills? Well, CLAWD agent skills are a specific set of instructions and contexts that can be called on [02:03] by Claude, whether using Claude code, the web or desktop app to do a specific set of tasks. And [02:10] Claude Skills solves a really interesting problem for anybody using AI, which is [02:16] reusable workflows with a set of instructions that you want to call on demand depending on the context of your conversation. Now, [02:25] Many of you are going to say, why can't I use Cloud projects for this or, you know, open AI custom GPTs or projects? [02:32] Well, those really stick with the context you've loaded in those projects. Once you set up a project, [02:39] Those chats associated with those projects always call on that context and instructions. It's not really dynamic. [02:46] And you can't call on a project on demand [02:50] to get it to follow a set of instructions. [02:53] Also, what I've seen is cloud projects and OpenAI projects and GPTs generally have general-purpose context. [03:00] that can feed a variety of tasks but aren't really task-specific instructions. [03:06] And so what Claude Agents gives you is the ability to really define

[03:11] task specific instructions, examples, and even scripts you can run. [03:16] that allow your general purpose chatbot to really do tasks on your behalf. [03:23] And what's nice about Claude's skills that I like is that [03:29] It really is just natural language. [03:32] We've seen so many releases around agents that are really workflow built. If this, then that, call on this tool. [03:39] And my preference as a general AI builder is [03:43] you know what, if these models are so great at natural language, we should be able to define things in natural language. [03:50] And so what Claude's skills essentially are are markdown files with [03:55] instructions and metadata and linked files that allow you to call on demand [04:01] A task or skill... [04:03] give a specific set of instructions and then really get that task or skill done. Now, [04:08] Here are some of my observations. [04:11] on the general structure of Claude's skills. [04:15] One, I think they're a really nice way to define and discover tasks that you're doing over and over and over with people. [04:25] an LLM. So if you find yourself constantly [04:28] analyzing data a specific way, creating a document a specific way, going through a workflow or running a script, [04:35] You want these sort of like micro instructions that stay consistent over time. And I know so many of you have.

[04:42] a Google Doc or a Markdown file or GitHub repository where you just kept all these prompts and you're copying and pasting them in. [04:50] Claude's skills really gives you a structured framework. [04:53] for filling out and reusing those tasks over time. [04:59] I would say the other thing that skills do quite nicely is bundle additional content and context into a skill. [05:08] through relative file references. So a Claude skill can reference other files in its folder, [05:16] And those reference files can be [05:19] examples, they can be templates, they can be additional instructions, and [05:24] It helps Claude [05:26] manage context a little bit better. So you're always going to get the agent instructions, [05:32] and when necessary you will get the contextual files linked to from the agent so I think [05:38] The discovery and context management of Claude's skills, as you see here in their help guide, [05:45] in their help article where they're describing the context window, how many tokens it uses, and when it's called on demand. [05:52] is very, very useful. [05:54] I would say the last thing is that [05:57] Claude skills can come bundled with executable Python scripts. And so this is maybe for more of the technical audience out there. [06:06] But if you want validation of your skills, if your skills are running some sort of analysis,

[06:12] data cleaning, technical implementation, the ability to reference Python files within [06:19] a clawed skill is actually a really interesting extension and [06:25] keeps you from having to rely [06:27] on the agent and the LLM itself to define that Python for you and run it in a consistent way. And so [06:34] While many of these tools, including Claude, have [06:38] sort of... [06:40] code execution capabilities when they're generating that code themselves [06:44] you can see that you get high variability in the definition of these scripts or the code. And [06:49] The ability to actually write out executable scripts that would be consistently used that you feel like are representative [06:58] of the code you want to write is very, very useful. So this is what cloud skills are. [07:03] And to actually really sum it up, because [07:06] I've described what they do and kind of the structure. [07:09] Cloud files is a folder. Like, I don't feel we have been explicit enough in some of the documentation. [07:16] to talk about exactly [07:18] What is a Claude skill? One of the things that I think that these core model providers can do, including Anthropic, love you, but here's some tips for you. [07:26] is [07:27] These are clearly primitives built by engineers expected to be grokked by everyday people. [07:34] And I'm going to sit here and translate them for you. So a clod skill, the actual object, the thing that you make, [07:41] is a folder that folder has a skills.md file in it.

[07:47] And then it can have additional [07:49] files next to it. So at the end of the day, how you set up a Claude skill [07:55] no joke, is you either put it in a folder for Claude Code, [07:59] to reference. [08:00] or you zip up this folder and you upload it [08:04] to the Claude.ai website. So I just want to, you know, I spent actually a good five minutes [08:09] trying to figure out like [08:10] what the hell is the asset of the skill. And the actual asset is a Markdown file, [08:17] a set of other files and folders, [08:20] either used by cloud code in your local directory or [08:27] zipped up and uploaded to the cloud. So that's how they actually work. Now, [08:31] I want to talk about what's in the structure [08:33] of those files because I think it's really important as we start to create clawed skills you know what's in the file so I'm just going to walk through some of the documentation on this [08:42] So every skill has to have a skill... [08:45] They like write it in all caps. S-K-I-L-L dot M-D. [08:49] File, that's going to be your prompt, your set of instructions. [08:53] Now, the difference between a general set of instructions and open language set of instructions and a skill is it actually has some structured content in it. [09:04] that you need to know about when you're creating a Claude skill. So the first thing you need to know about [09:09] is the metadata. [09:11] And this is just a piece at the top of your skill file that you put in in this particular format.

[09:18] That gives you the name of the skill so you know what it's named in a description, what it does. [09:23] So this is going to help the agent in Claude actually know when to call this skill. [09:30] The second thing that you're going to have in that file is instructions. So this is where all your prompt engineering skills need to come into play. [09:39] you would put your prompt instructions custom things in markdown in markdown formatting [09:46] which AI is very good at generating in the body of the markdown file. So at the top you have your metadata. [09:53] And then you have your prompt instructions. [09:55] And then there is resources and other code that can be referenced from that skill.md main instruction. [10:04] And the way you're going to do that is actually give the content a relative link to that file. [10:13] little dot slash. [10:15] filename or ./foldername with the filename. [10:18] If you don't know how to define relative file structure for code, [10:23] Again, good news. AI is very good at that. And we'll give you some examples when we generate AI code. [10:29] But you can reference folders next to the agent's [10:34] agent's markdown file and you can also reference [10:38] other files. So again, your skill.md is going to be your master prompt, and then you can reference other files in which you can put additional context. [10:47] that will be called as necessary by the skill.

[10:51] And then again, as I said, you're either going to put this in a place where Cloud Code can use it, or you're going to zip this up and create a skill in the web app. [11:01] So I wanted to create my first skill and [11:04] Anthropic in their launch documents actually said that there is a create skill skill inside Claude. So I couldn't really find it, but I just guessed that if I went into a chat, [11:15] I could ask Claude.ai to actually create a skill for me. [11:21] And so... [11:22] I just went in here and wrote in the quad web app, help me create skills. [11:28] And it does say that skills in this context are specialized instruction sets that help me perform tasks more effectively. So it seemed to me. [11:36] Like it does have a specialized meta skill inside loaded and clawed that can help you build skills. [11:42] And I'm just going to walk you through the chat because there are some interesting experiences actually trying to build a skill in Claude and Anthropic. Again, I love you. [11:51] but ran into some sharp edges. And I'm gonna show you the way I'm really generating skills in Fort Claude. [11:57] And so I asked it to create skills and on brand, I asked it to create a PRD generation skill. [12:04] And so. [12:05] What was interesting about watching this Cloud Code skill to create skills, very meta, is [12:12] generate is it did seem to go through a pretty structured workflow. So it gave me a sense of how these Claude agents actually think differently.

[12:21] about using skills [12:24] It read an example skill, which I'm presuming is in the instructions of the skill itself. [12:29] It looked at detailed examples, [12:32] And then it kind of understood what it needed to do. And it created this skill.md. [12:39] with again the metadata [12:41] At the top, I'm actually going to switch into Markdown View so you can see exactly what it's supposed to look like. [12:46] has the metadata on top and then a set of instructions here. Now, something I learned from the Claude [12:53] skill generator is, man alive are these instructions quite detailed. So [12:59] Even if you don't end up using this flow in Claude to create your skills, and I'll show you what I did. [13:05] which is a little bit more efficient, [13:07] you can see the outline of what it thinks a good skill is. So it includes when to use the skill, [13:14] What is a decision tree on [13:18] on different types of decisions it needs to make about executing the skill, [13:23] What's the template that it might follow when creating a document, which is quite long, actually? [13:30] writing best practices, all those sorts of things. And then it gave a couple example PRD formats for the skill to choose from. [13:40] So you can be very prescriptive about what a skill does, or you can be more general purpose or give it a lot of options. That's something that I noticed about skills. [13:49] And then finally, it gives some questions to ask users. So this is something interesting I wouldn't have put in my own prompt if I hadn't seen it.

[13:58] in this skill generator, but putting questions that the agent can actually ask users [14:04] to get more clarifying detail is very interesting. [14:08] output format, so being very prescriptive about the output of the skill itself. And then it gives a bunch of examples. [14:14] And you can see at the bottom, [14:18] Two things that I thought were interesting that I'm unsure if they're used, but very curious is keywords. [14:23] So I'm presuming these are keywords that invoke the skill itself, something again that I wouldn't have thought of when writing the prompt, but is very useful. [14:32] And then additional resources, it's really linking to the example documents that it's going to create as that additional context. [14:40] and so this is a really good example of how to write a good clod skill so even if you don't actually use this flow it's worth generating just one [14:51] to give you a good idea of what it takes to build a great Claude skill. [14:55] And then where it kind of went off the rails is... [14:59] It created the core skill. It created a license file, which I didn't really want. [15:03] It created... [15:05] a quick reference guide which is not really used it created a bunch of example files it checked the file sizes like [15:13] I think the challenge with using this tool, or at least my experience of using this tool in Quad AI, is it did a lot of unnecessary work that kept me from actually doing. [15:23] using the skill. So it created probably [15:26] um let's see one two three four five six seven eight

[15:31] 12 files, it created 12 files. [15:33] when I really only needed [15:35] five, [15:36] And then the crummy thing is when I actually tried to download the files, it failed. I got an error. [15:44] And so I would have had to download these files one by one. [15:50] and put them in a folder and upload them. [15:52] in a zip to get them to be to be effective files. So I think this flow using Cloud.ai to generate a skill was interesting to figure out. [16:01] how the system is prompted to generate a good skill, but I wouldn't say it was the most effective way to create a skill itself. [16:08] So what was a better way to create Claude skills? Well, I'll tell you, I found that creating Claude skills in Cursor was the easiest way. [16:17] to get this stuff done and so what i did is i created a completely empty folder [16:22] In my local machine, I opened up that folder. It's called Claude Skills. [16:27] I opened up that folder in cursor and I started [16:31] a chat that said create me a agent slash skill for creating cloud skills [16:36] here are the docs. So instead of relying on the clod skill itself that Anthropic put out, [16:42] I just literally gave cursor the link to the documentation about what the structure of a skill looks like and asked it to create a skill to create skills. [16:51] I will say this was much faster than creating it on Claude on the web app. [16:56] It took probably three minutes where I think the web app took probably 10 minutes to generate and they didn't get the files.

[17:03] And it created this nice little to do. And you can see again, it's following the instructions for creating good style. [17:08] create the main skill.md file, create example skills, create template files and a validation script. And you can see all of this was put in a create skill folder. [17:18] Over here, [17:20] and the skill [17:23] followed again that YAML formatting with the metadata at the top. [17:27] the instructions in the body, it was a little shorter than what [17:31] Claude generated it with its skills user and it did link and reference other files [17:37] And you can see those template files were generated in a really nice way. [17:43] One of the interesting things that Cursor did when creating a skill for me that I was actually surprised about is it created a skill [17:51] validation script and so again this is just an example of how you can use python [17:58] within your skills is you can actually, as part of your skill development, ask it to run a Python script. [18:04] This one is a kind of funny one where it checks the YAML validation and the file formatting and if a file exists and does little content changes. [18:12] content validation. So this is an interesting meta use of [18:16] the Python script calling ability, but [18:20] It works. It was useful. [18:22] And so this just a few, just a few minutes and... [18:27] Now I have this lovely create skill [18:31] folder that Claude can use. Now,

[18:34] How do we actually use that? [18:38] I'm not happy I have my quad skill set up. Well, what I really did to actually use this skill [18:44] is I fired up Claude code. So as I said, these skills are available in Claude code, Claude desktop, [18:51] the web app, as well as in the API, although we're not gonna go into the API today. And so I thought, because these files are local on my desktop, [18:59] that I could just use [19:01] Claude Code to call these skills. And [19:05] I really wanted to see if I just fired up [19:08] Typed Claude. [19:09] in this directory and called the skill if it would just call it [19:13] And... [19:14] It did. So you can see the first prompt I put into quad code. [19:18] is use the create skill skill to create a skill. This is, you know, say that three times fast. [19:23] for turning changelog entries into a user facing newsletter. So this is something that I do [19:27] Every week for ChatPRD, I take all of our technically generated changelog entries and I write a user facing newsletter that goes out to all of our subscribers. [19:36] And something that follows a very specific format, has a very specific input, very specific output, I thought it'd be great for a cloud skill. [19:43] So, [19:45] QuadCode picked up that skill right away, which is really nice, and helped me create a skill for turning changelog entries into user-facing. [19:54] Newsletter. So it's going through the repository or the folder. It's looking for where the skills exist. [20:01] and it found my CreateSkill Markdown file. It read it.

[20:06] and it understands the structure of creating a skill. And then it went ahead and created a directory for my [20:12] change log to newsletter skill, [20:15] wrote the content in the right format, [20:18] validated the skill with that Python script, [20:21] And then gave me [20:23] a summary and this skill is much simpler than the skill I generated before. As you can see, it's a single file. It has the metadata at top and then it has a long set of instructions. [20:33] So again, you don't have to use all these linked files and folders when you're creating skills. [20:38] you can really put in a good prompt and have that be that. [20:43] But now I have another skill in this Claude Skills folder or repository generated by my meta [20:50] create skills. [20:52] Skelp. [20:52] And then what I did once that skill was generated, [20:57] is I actually... [20:59] called it. And what was really fun about using this is you don't have to use like a magic or a magic word. [21:06] You don't have to say like invoke the Claude skill to do A, B, and C. [21:10] you can literally I said, OK, here's the latest change log. So [21:14] The only keyword it had was [21:17] Change log. [21:18] And with that context, the Claude agent was able to take [21:23] my changelog and say I'm going to [21:25] take this technical change log and turn it into an engaging newsletter. So I didn't say [21:30] Turn it into a newsletter. I didn't say use the skill. [21:33] I literally just said, here's a change log, and it inferred what I wanted based on the skills available in my folder.

[21:40] and wrote a update for our October 2025 product updates. [21:45] Now, looking at this, what's interesting is I would look at this and I would go, maybe my skill is a little too emoji heavy, and I would... [21:53] revise the skill over and over and over again to make sure it follows the format and structure that I want for [22:00] the task at hand. But at the end of the day, this took me [22:04] three minutes to create the skill and probably one minute to generate the newsletter. [22:09] And now I have a skill that I can use all the time. [22:14] just thinking for through other skills I might generate [22:18] I could do something like... [22:20] create a skill to turn [22:23] customer demos into follow-up emails for trial. [22:28] prospects. [22:30] What Claude Code is going to do now is it's again going to invoke that skill creator skill. It's going to create a new skill over here. [22:37] In the left hand, which you see already, demo to follow up. [22:41] it'll put the instructions in and ready to go. So for anybody that's trying to get started with clawed skills, [22:47] This is the flow that I would recommend. Create a folder that you can go into on your computer. [22:54] Make it your Claude Skills repository. If you want to get fancy and deploy it to GitHub, you can. Maybe I'll deploy this one to GitHub and share it with you all. [23:01] Create a skill to create a skill. [23:03] or maybe I'll [23:04] Again, share this with you all and you can clone my skill. [23:08] And then just ask Claude Code to make your skills. And then whenever you're in Claude Code in this

[23:15] you know, folder, [23:16] What you can do is invoke those skills to do a variety of tasks that you think are really important and improve the quality of those tasks. [23:26] over time. So that's the really simple guide to creating [23:30] quad skills in [23:32] cursor. So let's see... [23:35] It's thinking about it. It's taking 74 seconds. We'll wait one minute and see what comes back for our... [23:43] Demo to follow up skill. OK, so about three. Again, I think these just take three minutes. Three minutes later, it wrote. [23:50] This demo to follow up skill, which we can see up here. [23:54] that transfers customer demo notes into personalized follow-up emails. It's running the Python validation script on that skill, which, again, I think it's a little bit overkill, but, you know. [24:05] You do you, Claude. [24:06] And now I have, again, another skill here in my folder that I can invoke at any time. So that's how in about three minutes... [24:15] the little creative editing [24:17] you can get another skill for Claude Skills. Now, the last thing I want to show you is how you actually get those into the web UI or the desktop app, which I know a lot of you are using. [24:28] And so again, as I said, these are zipped up files that you need to upload into Claude. So [24:38] What you would do is go in to your finder or into your file browser in your desktop

[24:47] You would zip up [24:49] this file as you need into a zip. And then I'm going to, I actually haven't done this before, so we're doing it live. [24:56] you would upload that skill into [25:01] the capabilities [25:03] Well, this didn't work because my skill name can only contain lowercase letters. So I'm going to try that [25:09] Again, it seems like the skill names need to be [25:14] hyphenated little guys in here. So we're going to just do this one more time. I'm going to save this, I'm going to update my skill to write skills. [25:22] And [25:22] Let's try this again. Okay, so I'm going to zip this. [25:25] I'm going to try to upload this [25:29] demo to follow up skill in the Claude UI. [25:34] bravo i did it okay so i gotta update my thing and now i can transform customer demo notes into a personalized follow-up email [25:42] I can then use that skill now into my chat. And so... [25:47] You can see here that I just added the skill. Good job, Anthropic, doing that nice little seamless workflow into the chat. [25:54] It's going to read that skill. It's probably going to ask me for some notes. And then I can take my latest chat PRD demo and drop it right into Claude for it to create a follow up email on my behalf. [26:05] So that is our first mini episode on Claude Skills. I talked about what Claude Skills are, how they are differentiated against other ways you can provide context in your app. [26:15] how to try to create Claude skills using Claude, which is not my favorite, how to actually create Claude skills using Cursor, which is my favorite,

[26:24] and then how to invoke those skills using Claude code or the Claude web app by uploading them. [26:31] as a zip file, [26:33] If you like content like this, let us know. We're going to do deep dives on how to use some of the newest capabilities in these AI products. [26:41] I'll share some of how I AI in my day to day and we will get you the best [26:47] workflows in AI to improve your work life and your personal life. Thank you so much for joining Howie AI and we'll talk to you soon. Thanks so much for watching. If you enjoyed this show, please like and subscribe here on YouTube or even better leave us a comment with your thoughts. [27:02] You can also find this podcast on Apple Podcasts, Spotify, or your favorite podcast app. Please consider leaving us a rating and review, which will help others find the show. You can see all our episodes and learn more about the show at howiaipod.com. [27:20] See you next time.