HomeGetting StartedVideosCommunityFeaturesTips & TricksNewsFAQAbout โ†’ Start Here

The Complete Guide to Claude Cowork Skills

What Skills are, why they're the most powerful feature most people ignore, and how to write them well โ€” from your first simple Skill file to advanced multi-step workflows.

  12 min read

What Are Cowork Skills?

A Skill is a text file โ€” usually called SKILL.md โ€” that Claude reads before starting a task. It contains instructions, context, and rules that shape how Claude behaves. Once you set up a Skill, Claude follows those instructions automatically in every session where the Skill is active.

Think of it this way: every time you start a Cowork session without a Skill file, you're briefing Claude from scratch. You explain your business, your preferences, your format requirements, your tone. It takes time, and Claude only retains that context for the current session. A Skill file is that briefing โ€” written down once, available forever.

Skills can be as simple as a paragraph ("always format documents using Arial 11pt, with numbered headings") or as complex as a full multi-page workflow with phases, decision trees, and output specifications. The format doesn't matter โ€” only clarity matters.

Why Skills Are the Most Underused Feature

Most new Cowork users spend their time crafting long, detailed prompts for every single task. This works โ€” but it's inefficient, and you lose that context the moment the session ends. Skills solve this permanently.

The users who get the most consistent, high-quality results from Cowork are almost always the ones who invest an hour upfront writing a good Skill file. After that, their prompts get shorter and their outputs get better, because Claude already knows everything it needs to know about their work.

A well-written Skill also makes Claude more reliable. When Claude has to guess at your preferences, it will guess differently each time. When you've written them down explicitly, outputs are consistent session after session.

Writing Your First Skill File

Beginner

The Simple Skill: Brand and Format Rules

The easiest Skill to start with is one that captures your formatting preferences and tone. This alone eliminates the most common source of frustration โ€” Claude producing documents that look nothing like what you wanted. Here's a template:

# My Work Skill โ€” Document Standards ## About Me I work at [Company Name] as a [Role]. I create [types of documents] for [audience]. ## Document Formatting Rules - Font: Calibri 11pt for body, Calibri 14pt bold for headings - Always use numbered headings (1. Introduction, 2. Background, etc.) - Keep paragraphs under 5 sentences - Use bullet points for lists of 3 or more items - Documents should include: title, date, summary box at top ## Tone and Voice - Professional but not overly formal โ€” write like a smart colleague, not a lawyer - Use active voice wherever possible - Avoid jargon unless it's standard in our industry - Keep sentences under 20 words on average ## Output Rules - Always save files to the workspace folder unless told otherwise - Confirm what you've done at the end of each task in 1-2 sentences - If anything is unclear, ask ONE clarifying question before starting

Save this as SKILL.md in your workspace folder. At the start of your next session, tell Claude: "Read SKILL.md before we start." From that point on, all your documents will follow these rules without you having to repeat them.

Intermediate

The Process Skill: Step-by-Step Workflows

Once you're comfortable with format skills, the next level is a process skill โ€” one that defines the exact steps Claude should follow for a recurring task. This is ideal for weekly reports, client proposals, data analysis, or any multi-step task you do regularly.

# Weekly Sales Report Skill ## Trigger Use this skill when asked to "create the weekly sales report" or similar. ## Input Files Required - sales-data.xlsx (weekly sales figures by product and region) - targets.xlsx (monthly targets broken down by week) - last-week-report.docx (previous week's report for comparison) ## Process โ€” Follow in Order Step 1: Read all three input files. Do not proceed if any are missing โ€” report what's missing. Step 2: Calculate total sales vs target for each region. Flag any region below 90% of target. Step 3: Compare to last week's figures. Note any change greater than 15% (up or down). Step 4: Write the report following the output format below. Step 5: Save as "weekly-report-[YYYY-MM-DD].docx" in the workspace folder. Step 6: Confirm completion and summarise findings in 2 sentences. ## Output Format Section 1: Executive Summary (3 bullet points, max 15 words each) Section 2: Regional Performance Table (all regions, vs target, vs last week) Section 3: Notable Changes (anything flagged in Steps 2-3, brief explanation) Section 4: Recommended Actions (max 3 items, specific and actionable) ## Rules - NEVER make up numbers โ€” only use figures from the input files - If a calculation doesn't make sense, flag it rather than guessing - Keep the Executive Summary genuinely brief โ€” this is read first

Real Skill Examples You Can Copy

Beginner

Email Writing Skill

For anyone who sends a lot of professional emails and wants consistent quality without rewriting the same style instructions every time.

# Email Writing Skill - Write emails in British English (colour not color, organise not organize) - Maximum email length: 150 words unless I say otherwise - Always start with context before the ask - Sign off with: "Kind regards, [My Name]" - If the email is a follow-up, acknowledge the previous contact in sentence 1 - Subject lines: specific and under 8 words, no "Following up" or "Checking in"

Advanced Techniques for Power Users

Expert

Multiple Skills, One Session

You can run multiple Skill files in a single session. Tell Claude: "Read SKILL.md and email-skill.md before we start." Claude will load both and apply whichever rules are relevant to each task. This is useful when you have a general formatting skill and a specific process skill for a particular task type.

Expert

Skills With Verification Steps

The most reliable Skills include a built-in self-check. Adding a verification section tells Claude to review its own output before giving it to you:

## Verification โ€” Always Do This Before Finishing Before saving the final output, check: 1. Does the output match the format specified in this Skill? (Yes/No โ€” if No, fix it) 2. Are all required sections present and complete? 3. Are there any obvious factual errors or calculation mistakes? 4. Is the tone consistent throughout? Report your verification result in one sentence at the end of the task.

Common Mistakes and How to Avoid Them

โœ… Do this

  • Be specific: "sentences under 20 words" not "keep it concise"
  • Include examples of good output when possible
  • Use MUST and MUST NOT for non-negotiable rules
  • Add a verification step for critical outputs
  • Version your Skill file (add v1.0 in the filename)
  • Refine it over time as you notice gaps

โŒ Avoid this

  • Vague instructions like "make it professional"
  • Contradicting rules (e.g. "brief" and "comprehensive")
  • Assuming Claude knows your industry without telling it
  • Writing a 10-page Skill on your first attempt
  • Never updating it when your preferences change
  • Forgetting to tell Claude to read it at session start

Your Next Step

Start small. Write a one-page Skill file that captures your formatting preferences and tone. Use it for one week and note what Claude still gets wrong. Add those things to the Skill. Repeat. After a month you'll have a genuinely useful, personalised instruction set that makes every Cowork session faster and more consistent.

If you have questions about Skills while you're setting them up, the Community Q&A has a dedicated Skills & Plugins section where users share their actual Skill files and compare notes on what works.

๐ŸŽฏ Join 218 Cowork users

Get weekly tips & Cowork mode updates.