How to Build Claude Skills.

The hidden Skills system that makes Claude dramatically better at every file, doc, and workflow, and how to build your own.

May 18, 2026

Most people use Claude like a search bar.

Type a request. Read the output. Tweak it a bit. Move on.

That workflow works. But it’s leaving 80% of the capability on the table.

Here’s what I mean: Claude has a system built into it called Skills. You’ve never seen it mentioned in a launch post. It doesn’t have a settings toggle. But once you understand it, you won’t prompt the same way again.

By the end of this newsletter, you’ll get three ready-to-use SKILL.md files. You can upload the file and build your own skill.

The moment I found this

Two weeks ago, I was building a Word document pipeline inside Claude’s computer use environment. Every output looked technically fine - correct structure, proper formatting - but something was always slightly off. Wrong margins. Missing styles. Tables that broke on export.

I spent 4 hours debugging individual prompts before I stumbled onto something buried in the file system: a folder called /skills/ full of .md files. Each one was a dense set of rules, constraints, and best practices for one specific output type. Claude was supposed to read them before touching any file.

I hadn’t told it to. That’s why everything was breaking.

When I added the instruction to read the relevant SKILL.MD first - the output went from “almost right” to “ready to send” in a single run.

Here is the exact method to create any skill inside the Claude:

If this is useful, share it with one person who needs it. Takes 10 seconds.
Share

The old way vs. the new way

Old way: Write a long prompt. Hope Claude figures out the constraints. Fix the output manually. Repeat.

New way: Store the constraints once in a SKILL.md file. Claude reads it before every task. Output is right the first time.

Old way: Prompt → Mediocre output → Manual fix → Try again.

New way: Skill → Prompt → Usable output → Done.

The difference isn’t Claude’s intelligence. It’s whether Claude has the right context before it starts.

What a Skill actually is

A Skill is a plain Markdown file (.md). Nothing exotic.

It lives in a /skills/ folder inside your project or computer use environment. Claude scans that folder before writing code, creating files, or running commands. When the task matches a skill, Claude reads it first - then acts.

Think of it as a briefing document your new hire reads before their first day. Without it, they’re guessing. With it, they know your exact standards.

The format is simple:

name: docx
description: [When to trigger this skill]

# What to do
# What not to do
# Environment-specific constraints
# Examples

That’s it. Plain text. No special syntax. No configuration files.

The power is in the content - and in making Claude actually consult it.

Understand the 3 types of Skills

Before you build anything, know what you’re building.

Quick setup:

Skills break into 3 clear categories
Match the type to what you’re trying to solve
Don’t mix all three into one file - one skill, one job

Type 1: Output Skills: These cover specific file types - Word docs, PDFs, spreadsheets, slides. They encode constraints the average prompt misses: which Python libraries are available, how the environment renders certain elements, and what breaks on export.

Examples: docx, pdf, pptx, xlsx

Type 2: Workflow Skills: These define how Claude should approach a recurring task - writing a newsletter issue, running a code review, drafting a sales email. They encode your personal standards, your preferred format, and your non-negotiables.

Examples: newsletter writing, code-review, client-proposal

Type 3: Context Skills. These store facts Claude can’t know from training - your company’s tone guide, your product’s tech stack, your audience’s demographics. They’re not instructions. Their background.

Examples: brand-voice, product-knowledge, team-structure

How to build a skill:

Most people write Skills that are too long, too vague, or too theoretical. Claude skims them and ignores half the content.

Step 1: Go to Claude.ai, log in with Gmail there, and open a new chat.

Step 2: Click on the “+” icon in the new chat and then click on “Skills.”

Step 3: Click on “Manage Skills.”

Step 4: Again, click on “+” and then click on “Create Skill.”

Step 5: Click on “Create with Claude.”

Step 6: The first prompt will be autotyped; just press the Enter Key.

Step 7: Claude will ask you a few questions related to your skill, just answer them.

Step 8: Upload the files to Claude for analysis.

The number of files you upload for analysis, the strong will be skill and accurate will be the results of that skill.

Step 9: After completion of all analyses, Claude will generate the skill file.

Step 10: Save the skill file.

Step 11: Now test the results of your skill.

3 copy-paste prompts for Thumbnail Generation

AI & Technology-related Thumbnails:

YouTube thumbnail, 1280x720, dark sci-fi AI thriller style, ultra-high-CTR design.

BACKGROUND: Pure black canvas. LEFT half atmosphere: dramatic orange fire, rising 
ember sparks, heat haze distortion — apocalyptic warm glow. RIGHT half atmosphere: 
cold electric blue and cyan hexagonal circuit grid glowing pattern, binary code 
"0101" faintly dissolving in the background. Both sides bleed into center naturally.

LEFT SIDE — HUMAN FIGURE: A young adult male, positioned left 30% of frame, 
waist-up, facing slightly RIGHT. Expression: extreme fear and disbelief — wide 
open eyes, mouth open, both hands raised near face in alarm. Cinematic lighting: 
warm orange fire glow hitting his face from below, cold cyan rim light on his left 
edge. Photorealistic, cut-out composited onto dark scene.

RIGHT SIDE — AI ROBOT: A hyper-detailed chrome metallic humanoid robot, positioned 
right 30% of frame, facing slightly LEFT toward the human. Towering posture, 
dominant lean forward. Surface: polished titanium silver plating, visible circuit 
vein textures on neck and temples. Eyes: glowing intense RED-ORANGE. Cold blue 
rim light on its right edge. Photorealistic 3D render quality.

CENTER TEXT (stacked vertically, between both figures):
- Line 1: Bold ALL CAPS white text "AI WILL" — medium size, heavy black stroke
- Line 2: MASSIVE bold ALL CAPS text "REPLACE" — 3x larger than line 1, 
  deep blood red color with outer orange glow pulse effect, thick black stroke
- Line 3: Bold ALL CAPS white text "HUMANS" — same size as line 1, heavy black stroke
- Line 4: Small glowing yellow badge/pill shape with bold white text "BY 2026 ⚠️"

TOP FULL-WIDTH STRIP: Black and yellow caution tape texture reading 
"⚠ WARNING — DANGER — ATTENTION — WARNING ⚠" in bold black text.

BOTTOM FULL-WIDTH STRIP: Same black and yellow caution tape texture.

FLOATING ELEMENTS: 
- Three red warning triangle icons (⚠️) scattered: top-left corner, top-right 
  corner, bottom-right corner — each slightly different size for depth.
- Faint red digital scan lines sweeping diagonally across the entire image.
- Small floating robot hand reaching slightly toward the human from the right.

LIGHTING: Overall dark and moody. The fire and robot glow are the only light sources. 
Heavy vignette on all four edges pulling focus to center.

Style: Dark cinematic sci-fi thriller. Feels like a Terminator movie poster crossed 
with a breaking news alert. Ultra dramatic. Photorealistic quality. 
No cartoonish elements — everything hyper-detailed and serious.

Motivation & Self-Control Related Thumbnails:

YouTube thumbnail, 1280x720, cinematic motivational style — raw, powerful, disciplined.

BACKGROUND: Pure black canvas. No busy patterns. Subtle dark charcoal texture 
overlay for depth. Heavy vignette on all four edges pulling all focus to center.

PERSON: A strong adult male, positioned RIGHT half of frame, close-cropped 
from chest up. Expression: fierce, burning determination — jaw clenched, eyes 
intense and locked forward, slight forward lean suggesting dominance and control. 
TWO-COLOR RIM LIGHTING: left side hit with deep electric blue/purple cold light, 
right side hit with warm amber/orange fire glow. High contrast, dramatic shadows 
on face. Photorealistic, composited onto black background. No background from 
original scene — pure cut-out on black.

CENTER-LEFT — GLOWING BRAIN: Between the text and the person, floating at 
eye level — a hyper-detailed human brain rendered in glowing electric blue and 
purple energy. Neural network particle sparks firing across its surface. 
Pulsing light ripples radiating outward from the brain like sound waves. 
The brain appears to be under the person's mental command — not chaotic, 
but controlled and focused.

TEXT (LEFT SIDE, 45% of canvas, stacked vertically):
- Line 1: Bold ALL CAPS white text "CONTROL" — massive, heavy black stroke, 
  takes up full left width
- Line 2: Bold ALL CAPS electric yellow/gold text "YOUR" — slightly smaller, 
  same heavy stroke
- Line 3: Bold ALL CAPS white text "MIND" — same size as "CONTROL", 
  with subtle purple/blue outer glow matching the brain color
- Small italic white text below: "Master yourself. Master everything."
- Thin bright electric blue horizontal line beneath "MIND" as accent stroke

FLOATING ELEMENTS:
- Tiny neural spark particles drifting from the brain leftward toward the text
- Two small flame icons on either side of "MIND" text — subtle, not overpowering
- Faint purple energy wisps at the very bottom edge

LIGHTING ATMOSPHERE: The glowing brain is the main light source illuminating 
the scene. Everything else fades to pure black.

Style: Cinematic, disciplined, powerful. Feels like a David Goggins meets 
Christopher Nolan aesthetic. Minimal clutter — maximum impact. 
No cartoonish elements — serious, raw, photorealistic.

Wealth & Finance related Thumbnails:

YouTube thumbnail, 1280x720, aspirational money and wealth style, ultra-high-CTR design.

BACKGROUND: Deep rich emerald green base. Bright neon green radial glow burst 
exploding from dead center of the canvas, fading to dark forest green at edges. 
Dozens of US $100 bills flying and floating across the ENTIRE background — 
scattered at all angles, various distances creating depth layers. Some bills 
close and sharp in foreground, others blurred and small in background. 
The entire scene feels like an explosion of cash raining from above.

PERSON: A young confident adult male, positioned CENTER FRAME, waist-up. 
Expression: massive ear-to-ear smile, eyes wide with excitement and joy, 
both hands raised open with palms facing up — as if saying "look at all this money." 
Clean casual outfit (white or grey t-shirt). Cut-out composited onto the green 
money scene. Bright warm lighting on face. The green glow from background 
reflects subtly on his skin.

TEXT — TOP OF CANVAS (above person's head, full width):
- Bold bright yellow/gold 3D text "3 WAYS TO" — medium size, heavy black stroke, 
  gold metallic sheen
- MASSIVE bold ALL CAPS gold/yellow text "EARN MONEY" — 2x larger, 
  with deep gold metallic gradient and thick black stroke, slight 3D extrusion effect
- Bold white ALL CAPS text "ONLINE IN 2026" — medium size below, heavy black stroke

NUMBER BADGE — TOP LEFT CORNER: Large bold circle badge in bright yellow with 
thick green border — bold black number "3" inside, small white text below it 
"PROVEN WAYS"

FLOATING ELEMENTS:
- 3 glowing green rounded rectangle method boxes floating in LEFT background 
  (behind person) labeled: "① Freelancing " "② Dropshipping " "③ YouTube " 
  — each in white bold text on semi-transparent dark green box
- Stack of banded $100 bills in bottom-left foreground corner
- Money bag with $ symbol in bottom-right foreground corner  
- Green upward trending arrow chart faintly visible in top-right background
- Gold checkmark badge bottom center: "✅ WORKS IN 2026"

LIGHTING: Warm bright lighting on person. Neon green atmosphere. 
Money bills catch light at different angles creating visual depth.

Style: Abundant, exciting, aspirational. Feels like easy money is within reach. 
High energy, high saturation. Photorealistic person, stylized environment.
Professional YouTube Money channel aesthetic.

If there’s any error then edit the skill just by typing its trigger name starting with a “/” and then tell the Claude what you want to edit. After this save again the file and check again the results.

Now your skill is developed.

Build a reference skill for your own voice

Here’s the use most people don’t think of until they try it once: a Skill for how you write.

A voice skill stores your tone, your formatting preferences, your vocabulary rules, and your banned phrases. Every time Claude writes something on your behalf, it reads this file first.

Quick setup:

Create /my-voice/SKILL.md
Include: tone description, sentence length preferences, words you never use, words you always use, and your sign-off style
Add examples - real samples of your writing labeled “good” and outputs labeled “not my voice.”

---
name: my-voice
description: Use this skill any time you are writing as me — emails, posts,
newsletters, replies, or any text that will go out under my name.
---

# My voice
- Direct. No filler. Every sentence earns its place.
- Short sentences. If it can be split, split it.
- I never use: "leverage", "synergy", "at the end of the day", "touch base"
- I always end emails with one clear next step, not a vague close

# Examples of my voice
[PASTE 3-5 REAL SAMPLES OF YOUR OWN WRITING HERE]

“The examples section is worth more than all the rules. Claude learns voice from patterns, not descriptions. Show it. Don’t just tell it.”

Before you move on - pause here. You’re about to write your first Skill. I know it looks like a small markdown file. It’s not small. This one file will outlast 100 prompts. The prompts you write today will be rewritten next week. The Skill you write today will run in the background for months. Take 15 minutes on it. Make it specific. It compounds.

The use cases that matter

Content creators

Store your newsletter format, your section structure, and your word count rules. Stop re-explaining your format in every prompt. The skill does it once, permanently.

Developers
Store your tech stack, your naming conventions, your forbidden patterns. Claude stops suggesting libraries you don’t use and starts writing code that fits your repo.
Consultants and freelancers

Build a client skill per engagement. Store their brand voice, their preferred output format, and their terminology. Onboarding Claude to a new client takes 20 minutes instead of 20 prompts.

Operators building with the API

Skills are system prompt sections you maintain separately and inject cleanly. Modular, versioned, reusable. Much cleaner than a 3,000-word monolithic system prompt.

These are the use cases that matter. Skip the rest until you’ve nailed these.

This newsletter grows from your shares. If you got value from this, pass it on.
Share

Your free gift - as promised

A Starter Skills Kit: 3 SKILL.MD templates ready to customize.

Includes:

Thumbnail Generation skill
Script Writing skill
Prompt Engineer skill

Click on the Notion link below and get your copy-paste skills:

Click here to get your gift.

Start with one skill. The one for your most repeated task. Build from there.

I spent the last 2 weeks building a prompt library for content creators, with 150 structured prompts covering content creation across all social media platforms. I'm giving it away in full today.

Here are the few issues that you might have missed (go check them out):

If this issue helped you, forward it to one person who needs it. It's free, and it takes 10 seconds. Sharing is always caring:)

Become a paid subscriber: Get every past issue of AI In Public, plus exclusive resources, prompts, and early access to everything I build next.

And for shorter takes between issues, follow me on X → Hamza Khalid
Hamza 💙

AI in public

Discussion about this post

Ready for more?