Feature deep-dive

Claude Skills: Create, Run, and Share Reusable Prompts, Step by Step

A skill is a single markdown file holding a prompt you reuse. Build one with the built-in skill creator on claude.ai, invoke it with a slash command, run it across chat, Cowork and Claude Code, and pick one of four ways to share it with your team.

SKILL.md file for a thread-reply Claude skill opened from the .claude/skills folder in Visual Studio Code, with the YAML description frontmatter telling Claude when to trigger above the markdown body
The thread-reply SKILL.md in VS Code: a description frontmatter that tells Claude when to fire, above the markdown body that says how.

An illustrated walkthrough of 15 steps - about 5 minutes to read. Every step links back to the exact moment in the source video.

TL;DR

A Claude skill is one markdown file with a saved prompt: a frontmatter block carrying the name, description and trigger phrases, and a body with the actual instructions. Create it on claude.ai under Customize → Skills with the built-in skill creator, answer its questions, test against a real thread, and hit Save skill. Invoke it by typing / plus its name — more reliable than waiting for Claude to infer it — and the same skill follows you into the desktop's chat, Cowork and Code apps with no reinstall. Claude Code is the exception: it reads skills from folders, so you download the file as a zip, drop the folder into .claude/skills (project) or ~/.claude/skills (global), and start a new session. Share with your team via zip, organization skills on Teams and Enterprise plans, a synced cloud drive with a CLAUDE.md pointer, or git for version history.

Source video

This page follows the Kevin Stratvert recording of building a skill end to end and rebuilds its steps one frame at a time. Every screenshot links to the exact moment it appears.

Screenshots are frames from the video, credited to the creator; the write-up is our own. Steps verified against the video in September 2026.

guide_claude_code_skills.sections.creation_title

guide_claude_code_skills.sections.creation_subtitle

  1. 1

    Open Customize → Skills and click Create skill

    Skills live behind the Customize item in the claude.ai sidebar, under the Skills tab — the recording opens an existing dashboard-updater skill first to show the layout. No paid plan is required to create one. Click the plus button, choose Create skill, and the menu fans out into three paths: Create with Claude, Write instructions, and Upload skill. The first one hands the job to Claude's own skill-creator skill.

    Claude.ai Customize Skills screen with the plus-button menu open on Create skill, showing the Create with Claude, Write instructions and Upload skill options beside an existing dashboard-updater skill
    Three ways in; Create with Claude does the interviewing.Watch at 1:20
  2. 2

    Answer the skill creator's questions

    Bring a plain description of the job: given a long email or Slack thread among coworkers, summarize the main points, call out action items, and draft a response. The creator comes back with numbered questions — input format (pasted text, forwarded email, Gmail connector), which trigger phrases should invoke it, output shape, whether action items cover only your items, and whether to draft by default or ask first. Adding "what else should I clarify?" to the first message makes it ask instead of assume. The answers become the skill, so respond thoughtfully.

    Claude skill creator asking numbered clarification questions about input format, trigger phrases such as thread-reply, output shape, action item scope and whether to draft by default or ask first
    Questions about inputs, triggers and output shape.Watch at 2:45
  3. 3

    Review the draft: frontmatter plus body

    The drafted skill is a single markdown file, and the draft names its path (/home/claude/thread-reply/SKILL.md) while splitting it in two. The frontmatter describes the skill: it triggers on the thread-reply shortcut and on natural requests, and its description deliberately leans pushy because Claude tends to undertrigger skills. The body is the prompt itself: produce Summary → Action items for you → Draft, in that order, with the owner's voice, examples and edge cases spelled out. Simple skills stop here; complex ones can also embed code, like a dashboard-updater skill that ships with Python.

    Claude skill draft at /home/claude/thread-reply/SKILL.md split into a Frontmatter with the thread-reply trigger and pushy description note, and a Body listing What to produce, David’s voice, examples and edge cases
    One markdown file, two halves: metadata and prompt.Watch at 2:52
  4. 4

    Test against a real thread, then Save skill

    The creator proposes test cases before turning the skill on — paste a real thread and it returns a summary, action items and draft replies. Feedback here is where the real work is, so send corrections as plain prompts. When the tests pass, tell Claude to create the skill (it will otherwise keep asking for feedback), and the finished file lands in the preview pane with a Save skill button at the top. After saving, thread-reply appears in the skills list with its description and trigger settings.

    Claude conversation answering Create the skill after test approval, with the packaged thread-reply skill file, its Save skill button, and the SKILL.md preview showing the description frontmatter in the right pane
    Approved tests, packaged file, one click to install.Watch at 4:18

guide_claude_code_skills.sections.running_title

guide_claude_code_skills.sections.running_subtitle

  1. 5

    Invoke it with / plus the name

    A skill fires in two ways: Claude infers from context that it is needed, or you type the name directly. The recording is blunt about which is better — inference keeps improving, but the direct shortcut is more reliable. Type a single forward slash in any chat and an autocomplete window lists every installed skill with its description, so you never have to memorize names. Pick thread-reply, paste the thread, send.

    Claude chat input with a forward slash opening the skill autocomplete window listing payroll-check, thread-reply, dashboard-updater, skill-creator and other installed skills with the payroll-check description tooltip
    A forward slash lists every skill with its description.Watch at 6:20
  2. 6

    The same skills in the desktop's three apps

    Install the Claude desktop app and you get three surfaces in one window: chat, Cowork and Code, switchable from the sidebar. Customize → Skills is there too, and the thread-reply skill created on claude.ai is already in the list — nothing was installed separately. The environments are connected, so a skill saved once follows you across all of them.

    Claude desktop app home screen with the Chat, Cowork and Code app switcher in the sidebar beside the Coffee and Claude time prompt box and the Write, Learn, From Drive quick actions
    Chat, Cowork and Code under one roof.Watch at 7:17
  3. 7

    Confirm the skill arrived on desktop

    Back in Customize → Skills on the desktop app, thread-reply sits under Personal skills with the same description and trigger settings as on the web. From here you can run it in a chat, or let Cowork pick it up when working in a folder — same skill, same behavior, and no sync step to perform.

    Customize Skills page inside the Claude desktop app listing the thread-reply skill under Personal skills with the same description it had on claude.ai, added by You on Apr 30, 2026
    Same skill, same description, zero reinstall.Watch at 7:27

guide_claude_code_skills.sections.claude_code_title

guide_claude_code_skills.sections.claude_code_subtitle

  1. 8

    Claude Code plays by different rules

    Open Claude Code inside VS Code — the recording prefers this view because the workspace files stay visible beside the panel, and notes that everything shown works in the terminal too. Type a slash and the skill list does not match what claude.ai showed. Skills are installed differently here, and the fastest way to understand it is to ask Claude Code about global versus project skills.

    Claude Code extension panel open in Visual Studio Code beside the donut-den workspace explorer showing business-overview.md, financials-ytd.md and team-roster.md, with an empty Ask Claude to edit input
    The slash list in Code starts empty for a reason.Watch at 8:40
  2. 9

    Global or project: two folder scopes

    Claude Code's answer spells out the paths. Project-level skills go in a .claude/skills/ folder inside the project root, and are only loaded when Claude Code runs in that project. Global ones live under ~/.claude/skills and are available across every project on the machine. Plugin skills bundle under the plugin's own directory instead, and each skill is its own folder containing a SKILL.md with YAML frontmatter plus any supporting files.

    Claude Code answer highlighting that project-level skills live in a .claude/skills folder inside the project root such as c:\Users\...\donut-den\.claude\skills, while global skills sit under ~/.claude/skills
    Project scope for team repos, global scope for personal helpers.Watch at 9:16
  3. 10

    Download the skill and rename it .zip

    To move a web-built skill into Code, go back to the Skills view on the desktop or web app, select the skill, open its three-dots menu and click Download. When the browser asks for a file name, rename the extension to .zip — the download otherwise arrives as a single skill file. Extract it and you get a folder with the skill file inside.

    Browser Save As dialog over the thread-reply skills page renaming the downloaded skill file to thread reply.zip so it can be extracted and installed into Claude Code
    The .zip rename is what makes it extractable.Watch at 9:50
  4. 11

    Drop the folder into .claude/skills

    With the project folder open in VS Code, copy the extracted thread-reply folder — the folder, not the skill file alone — into a skills folder inside a .claude folder. The explorer now shows .claude/skills/thread-reply/SKILL.md. The current session will not see it; start a new one, type the skill name after a slash, and it is recognized. The same .claude/skills structure also works within Cowork, so a folder shared with someone can carry its own skills.

    VS Code explorer showing the imported skill at .claude/skills/thread-reply/SKILL.md inside the donut-den project, with the Claude Code chat answering how to create a project skill
    Folder in, new session, slash command recognized.Watch at 10:20
  5. 12

    Read the file you just installed

    Open SKILL.md and the anatomy from the creation step is now on disk: a YAML frontmatter whose description tells Claude when the skill applies — summarize a long email or Slack thread, trigger even if the user never says "thread reply" exactly — then a markdown body carrying the sections to produce, the reply structure, and phrases that fit the owner's voice. This file is the whole skill, and you can edit it like any text file.

    thread-reply SKILL.md opened in Visual Studio Code from the claude/skills/thread-reply breadcrumb, showing the YAML description frontmatter above the # Thread Reply markdown body
    Frontmatter says when; the body says how.Watch at 13:45

guide_claude_code_skills.sections.sharing_title

guide_claude_code_skills.sections.sharing_subtitle

  1. 13

    Teams and Enterprise: publish org-wide

    The zip route works but forks versions: two copies exist, and once one is updated you are running two different skills. On Claude Teams or Enterprise, admins get an organization settings view with a Skills section. Upload the skill at the bottom, under Organization skills, and it becomes available to everyone in the workspace, with its own section in Customize → Skills. Members can use these skills but not edit them — ask the admin to download and send the file when a change is needed.

    Claude organization Skills page listing the contract-generator skill under Organization skills, added by Your admin on May 1, 2026 with a slash command plus auto trigger for the whole workspace
    Uploaded once by the admin, usable by the whole org.Watch at 12:00
  2. 14

    No Teams plan: a synced drive and CLAUDE.md

    An experimental workaround for teams on a shared OneDrive or Google Drive. Sync the drive locally, then right-click the working folder and choose the option that keeps it always on this device. Inside sit a .claude folder holding the skill, a CLAUDE.md file that preloads it, and the files the skill works on. OneDrive refuses folders starting with a dot, so the recording settles for a plain claude folder and leans on CLAUDE.md to point Cowork at the skills — advanced, but it shares skills through a drive the team already uses.

    OneDrive Contracts folder synced locally containing a .claude folder, CLAUDE.md, deal-notes.txt and template.docx for sharing a Claude skill with Cowork through a cloud drive
    CLAUDE.md loads the skill from the shared folder.Watch at 12:46
  3. 15

    Run it from the folder in Cowork

    Select the synced Contracts folder in Cowork and prompt: run the contract-generator on the deal-notes file. Cowork checks the CLAUDE.md instructions, reads SKILL.md from the skills folder, and follows the workflow — read the deal notes, scan executed contracts for similar deals, read the template, build the contract — while the Contracts panel tracks the instructions, SKILL.md and deal-notes.txt as context. The skill was never installed anywhere; the folder was enough.

    Claude Cowork running the contract-generator skill on deal notes, having read CLAUDE.md and SKILL.md from the folder, with the Contracts panel listing Instructions, SKILL.md and deal-notes.txt as context
    The Contracts panel shows CLAUDE.md and SKILL.md at work.Watch at 13:35

Frequently asked questions