Build guide

How to create a skill

A build guide from AutomationTactics. It covers what a skill is, the seven parts every skill needs, and the click-by-click steps in Microsoft 365 Copilot, Claude, ChatGPT, and Google Gemini.

Verified against official documentation as of September 15, 2026.

TL;DR

  • A skill is a written, reusable set of instructions for one task you do often, saved so an AI assistant follows the same steps every time. Write the task down first, the way you would explain it to a new hire, then load it into whatever AI tool you use.
  • The exact feature name changes by tool. Claude and Microsoft 365 Copilot both call it a Skill and both use a SKILL.md file. ChatGPT uses custom GPTs and Projects. Google Gemini uses Gems. The idea is the same in every one.
  • Two dates matter for planning. OpenAI plans to end creation of new custom GPTs (planned for September 25, 2026) and is moving people to Plugins, with Enterprise retirement scheduled for December 11, 2026. Microsoft's new "Skills" upload feature lives inside Copilot Cowork, while most non-developers will use the "Create an agent" builder in the main Copilot app.
Findings

What to know before you open a tool

  • The single most important step happens before you touch any tool. You write down how you do the task today. This matches the AutomationTactics method, Document-Train-Automate, where documentation is the foundation. You cannot automate what is not written down.
  • Every tool gives a non-developer a no-code path. Claude builds the file for you from a chat description, and Microsoft 365 Copilot fills in the agent fields from a plain-language description. Gemini has a wand button that rewrites rough notes into full instructions, and the ChatGPT GPT builder drafts the instructions through a conversation.
  • The description or the "when to use it" line is the part that decides whether the skill ever fires. In Claude the description determines when the skill triggers. Anthropic's own skill-creator guidance says to be a little "pushy," because Claude tends to under-trigger skills, so you should err on the side of over-describing when it should be used.
  • Sharing rules differ. Claude custom skills in claude.ai are private to each user on Free, Pro, and Max, and can be shared on Team and Enterprise. Microsoft agents can be shared to specific users or published to an org catalog. Gems can be shared by link or org-wide in Workspace. Custom GPTs can be shared by link or workspace.
  • Licensing is the most common blocker. Building a custom GPT needs a paid ChatGPT plan. Claude Skills are available on Free, Pro, Max, Team, and Enterprise plans, and require code execution to be enabled. Microsoft's agent builder is available to Copilot Chat users including free and pay-as-you-go, while the Cowork Skills feature needs a Microsoft 365 Copilot license with Cowork and usage-based billing enabled.
Definition

What a skill is, in plain language

Skill

A skill is a document. It holds the instructions for one task you repeat, written so an AI assistant can follow them without you re-explaining every time.

Think about a task you do every week. You open the same files and make the same handful of decisions, and the output looks the same every time. Right now, if you ask an AI to help, you retype all that context into the chat. A skill saves that context once. After that, the AI applies it automatically when the task comes up.

Documenting the work first matters because the skill can only be as good as the instructions inside it. If the steps live only in your head, the AI has to guess, and it guesses differently each time. When you write the steps down, you get two things at once. You get a record a human teammate can read, and you get the raw material for the skill.

This is the Document step in the AutomationTactics Document-Train-Automate method. Write down how the work runs, and the AI has something to follow. Anthropic describes building a skill the same way, as putting together an onboarding guide for a new hire.

Pick a task that you do at least weekly and that follows roughly the same shape each time. A task where every case is a special case is not ready to become a skill. Fix the process first, then document it.

Anatomy

Anatomy of a good skill

A good skill has the same parts no matter which tool you load it into. Include these:

  1. A name. Short and descriptive. "Weekly Site Report Builder," not "Helper."
  2. A one-sentence description of when to use it. This is the trigger. Write it so the AI knows exactly which requests should call the skill. Name the task, the file types, and the words a user would say.
  3. The step-by-step procedure. Number the steps. Write them the way you would tell a new hire.
  4. The inputs the AI needs. List what you will give it each time, for example a pasted list, an uploaded spreadsheet, or a folder link.
  5. The expected output format. Say exactly what the finished result looks like, down to the sections, headings, length, and file type.
  6. Examples of good output. Paste one real example of a result you were happy with.
  7. Things to avoid. List the mistakes you keep having to correct.

Reusable template

Copy this and fill it in. It works as a plain document, and it also works as the body of a SKILL.md file for Claude and Microsoft Copilot.

SKILL.md template
---
name: [Short descriptive name]
description: [One sentence. What the task is, and when to use this skill. Name the trigger words and file types. Be specific.]
---

# [Skill name]

## When to use this
[Describe the situations that should trigger this skill.]

## Inputs I will provide
- [Input 1, for example: a pasted list of line items]
- [Input 2, for example: the current month's budget file]

## Steps
1. [First step, written plainly]
2. [Second step]
3. [Third step]
4. [Continue as needed]

## Output format
[Describe the exact structure of the finished result. Headings, order, length, file type.]

## Example of good output
[Paste one real example here.]

## Things to avoid
- [Common mistake 1]
- [Common mistake 2]
Before any tool

How to write the skill from your own work

Do this once, in a plain document, before you open any AI tool.

  1. Pick one task you do at least weekly. Choose one with a repeatable shape.
  2. Write the steps as you would explain them to a new hire. Assume they know the job but not your particular way of doing it. Number the steps.
  3. Note the decisions you make and why. Every place where you choose between options, write down the rule you follow. "If the invoice is over $10,000, route it to the PM first."
  4. Note the source files or systems you use. Write down where the input comes from and where the output goes.
  5. Note what "done" looks like. Describe what a correct, complete result contains and how you check it.

When you finish, you have a document a person can follow. That same document becomes the skill.

If you cannot think of a task to start with, the idea prompt on the Skill Factory page asks your AI tool to list the tasks you repeat. Copilot users have a walkthrough of their own.

Tool guide

Microsoft 365 Copilot

Microsoft splits this across a few places. For a non-developer, the simplest path is the agent builder inside the Microsoft 365 Copilot app, and that is where this section spends most of its time. Microsoft also shipped a feature named "Skills" in mid-2026 that lives inside Copilot Cowork, covered below. Copilot Studio is the advanced option and comes last.

Microsoft's agent builder produces a "declarative agent." That is Microsoft's term for a saved assistant made from your instructions, your knowledge sources, and starter prompts. It is the closest match to a skill for most users.

A. Create an agent with the agent builder (simplest path)

Licensing note. Microsoft states that Copilot Chat users, including free and pay-as-you-go, can create agents using the agent builder in Microsoft 365 Copilot Chat. When an agent runs inside Copilot Chat against your Microsoft 365 content, the usage sits on the user's Microsoft 365 Copilot seat.

  1. Open the Microsoft 365 Copilot app.
  2. In the left navigation, under Agents, select New agent.
  3. Describe what you want in plain language in the message box, then send. As you describe it, Copilot fills in the name, description, and instructions automatically. For example, "Create an agent that drafts weekly site status reports from my project SharePoint files."
  4. Keep refining by typing. For example, "Always group the report into Safety, Schedule, and Budget."
  5. To set fields by hand instead, select Skip to configure, which opens the Configure tab.

On the Configure tab you can set these fields:

  • Name. Descriptive and unique. Limit 30 characters.
  • Description. This helps Copilot decide when to use the agent. Keep it short and precise. Limit 1,000 characters.
  • Instructions. The step-by-step directions the agent follows. This is where your documented procedure goes. Limit 8,000 characters.
  • Knowledge. Up to 20 knowledge sources, including SharePoint sites, folders, and files.
  • Capabilities. Options such as code interpreter and image generator.
  • Starter Prompts. Example prompts shown to users. Each has a name and a description. There is no minimum number.

The minimum you need is a name, a clear description of when to use it, and the instructions. Knowledge sources and starter prompts are optional but worth adding.

Test it. After you create the agent, open the Try it tab and run it with a real request. Keep refining the instructions, knowledge, and prompts. You can adjust by natural language or by editing the Configure fields.

Share it. Select Create when you are ready. Then use the Share button to choose who gets access. Options include only you, specific users or groups, or everyone in your organization if org-wide sharing is enabled.

To make the agent broadly discoverable, open the More ellipses menu and select Submit to your org catalog. An admin reviews it in the Microsoft 365 admin center and, if approved, publishes it in the "Built by your org" section of the Agent Store.

B. Microsoft's "Skills" feature (Copilot Cowork)

Microsoft introduced a feature named "Skills" that uses the same SKILL.md format as Claude. Microsoft's documentation places it inside Copilot Cowork, the deeper, multi-step working mode you reach with the toggle in the Microsoft 365 Copilot app. The main Copilot Chat window does not have it.

Licensing note. Cowork requires a Microsoft 365 Copilot license, with Cowork enabled and usage-based billing turned on. Per Microsoft Learn, you can create up to 50 custom skills by placing SKILL.md files in your OneDrive /Documents/Cowork/skills/ folder, each up to 1 MB. That 50-skill limit is a June 2026 general-availability increase from the prior limit of 20.

To create a skill in Cowork:

  1. Open Cowork.
  2. In the left navigation, select Customize. The page opens with two tabs, Plugins and Skills.
  3. Select the Skills tab.
  4. Select Add to start a guided conversation that helps you write and save a new skill. To pick the mode, select the arrow next to Add and choose Create new for the guided flow, or Upload skill to import a file from your device.
  5. For upload, Cowork accepts a .md file containing a single SKILL.md, or a .zip or .skill archive with a SKILL.md at its root plus companion files. The file must include a name and a description in its frontmatter.

Note on field limits. Microsoft's own documentation confirms the required name and description in YAML frontmatter, and its troubleshooting text refers to a description that "exceeds the character limit," but it does not publish the exact numeric caps. Some third-party guides cite a 64-character name and a 200-character description drawn from the Claude Skills spec. We could not verify those exact numbers in Microsoft's documentation, so keep the description short and specific and do not treat a precise cap as confirmed.

Test it. Start a session and give Cowork a request that matches the skill. Active skills appear in the side panel during a conversation.

Share it. Open the skill's detail page on the Customize page, select Share, and choose Only you or Specific users in your organization. When you change a skill you already shared, select Re-share to update everyone you shared it with.

Separate from Cowork, Copilot in PowerPoint and Copilot in Excel each have their own custom-skill feature, managed through a "Manage skills" dialog and a Skills folder in OneDrive. Those are per-app and are not the same as the Cowork Customize page.

C. Copilot Studio declarative agents (advanced)

Copilot Studio is the more customizable builder. It is aimed at makers who need connectors, governance controls, and publishing across channels. You can copy an agent you built in the Microsoft 365 Copilot agent builder into Copilot Studio when you need those extra capabilities.

Licensing note. Copilot Studio is priced on consumption. Since September 1, 2025, the currency for agents is Copilot Credits, replacing the older "messages" term. You buy credits through pay-as-you-go meters or prepaid packs.

A declarative agent that runs inside Copilot Chat against grounded Microsoft 365 content draws on the user's Microsoft 365 Copilot seat rather than Copilot Studio credits. Custom-engine and autonomous agents draw Copilot Studio credits.

For most non-developers documenting a repeatable task, the agent builder in path A is the right starting point. Move to Copilot Studio only when you need something the simpler builder cannot do.

Tool guide

Claude (Anthropic)

Claude's feature is called Skills, and it is the clearest match to the concept in this guide. A skill is a folder with one required file, SKILL.md. That file starts with YAML frontmatter holding a name and a description, followed by markdown instructions.

Licensing note. Per the Claude Help Center, Skills are available on Free, Pro, Max, Team, and Enterprise plans, and the feature requires code execution to be enabled.

On individual Free, Pro, and Max plans you turn this on under Settings > Capabilities, confirming that Code execution and file creation is on. On Team and Enterprise plans, an owner enables both Code execution and file creation and Skills under Organization settings > Skills. Custom skills you create in claude.ai are private to your account on Free, Pro, and Max. On Team and Enterprise, you can share skills or have an admin provision them org-wide.

The description is the trigger. Claude reads it to decide when to load the skill. Anthropic notes that Claude tends to under-trigger, so make the description specific and slightly pushy about when to apply it. Instead of "How to build a dashboard," write something like "How to build a dashboard. Use this skill whenever the user mentions dashboards, data visualization, or internal metrics, even if they do not explicitly ask for a dashboard."

A. Easiest path. Let Claude build it by conversation (skill-creator)

Claude has a built-in skill called skill-creator that builds a skill from a plain description. This is the easiest path for a non-developer, because you do not edit any files by hand.

  1. Click your profile icon at the bottom left, then go to Settings > Capabilities.
  2. Toggle on both Code execution and file creation and Skills.
  3. Open the Example skills tab and activate skill-creator.
  4. Start a new chat and type, "Help me build a skill," then describe the task, the inputs, the output you want, and any rules.
  5. Claude asks clarifying questions, writes the SKILL.md file, and packages the skill. Watch the thinking trace to see the file take shape.
  6. When Claude finishes, click Copy to your skills to install it.

B. Create or upload it yourself in claude.ai

  1. Go to Settings > Capabilities and confirm Code execution and file creation and Skills are on.
  2. In the left sidebar, under Customize, click Skills. The direct link is claude.ai/settings/customize-skills.
  3. Use the Add dropdown in the top-right. Choose Create with Claude, Write skill instructions to paste text, or Upload a skill to import a .zip.
  4. If you are writing it yourself, paste your instructions using the template in the anatomy section.

C. Claude Cowork

Claude Cowork is the desktop working mode where Claude acts on your files. Skills you enable for your claude.ai account load automatically in Cowork. On Pro, Max, and Team plans, in Cowork on Claude for Mac, you can also record a skill. You send Claude a video of your screen, clicks, typing, and voice while you do the task once, and Claude proposes a skill for you to review before you save it. Recording is not available in chat, on Windows, or on Free and Enterprise plans.

D. Claude Code

For teammates who work in Claude Code, skills are files on disk. Place them in ~/.claude/skills/ for personal skills or .claude/skills/ for a project. Each skill is a folder with a SKILL.md file. This path is for developers and can be skipped by non-developers.

Test it. Start a new chat and give Claude a request that should trigger the skill. Try an explicit mention, "Use my weekly report skill," and an implicit one, "Draft this week's site report." Check that the skill loads.

Share it. On Team and Enterprise plans, open the skill and share it with specific colleagues, groups, or the whole organization, and admins can provision skills org-wide. On Free, Pro, and Max, skills are per-user. You can package the skill folder as a .zip and send it, and the recipient uploads it through their own Skills settings.

Tool guide

ChatGPT (OpenAI)

ChatGPT does not have a feature named "Skills" for everyday users. The closest equivalents are custom GPTs and Projects. Read the retirement note before you invest heavily in custom GPTs.

Retirement note. OpenAI has announced it plans to retire custom GPTs and move workflows to Plugins. New GPT creation is unavailable on personal ChatGPT accounts.

For affected Enterprise workspaces, the OpenAI Help Center lists three planned milestones. September 17, 2026 is the target for the migration experience and user banner. September 25, 2026 is planned as the end of creation of new custom GPTs. December 11, 2026 is the scheduled retirement, when custom GPTs stop running.

Existing GPTs stay usable until retirement. For a team that wants a durable skill today, Projects with project instructions is the safer choice.

A. Custom GPT

Licensing note. Creating a custom GPT requires a paid ChatGPT plan, Plus or higher. Once created, a GPT can be shared and used by others.

  1. Go to chatgpt.com/create and sign in, or open Explore GPTs and select Create.
  2. In the Create tab, describe what you want in plain language. The GPT builder drafts the setup for you.
  3. Click the Configure tab to set fields by hand:
    • Name. Clear and descriptive.
    • Description. What the GPT does.
    • Instructions. Your documented steps, tone, and rules. There is an 8,000-character limit on this field.
    • Conversation starters. Example prompts shown when the GPT opens.
    • Knowledge. Upload reference files such as procedures and templates.
    • Capabilities. Turn on web search, image generation, code interpreter, or canvas as needed.
  4. Prefer positive, concrete instructions, "Do X," over long lists of "Don't do Y."

Test it. Use the preview panel on the right side of the builder. Run a real request and adjust the instructions until the output is right.

Share it. Click Share and choose the access level. Options are only me, anyone with the link, and the GPT Store. Public listings require a category and a privacy policy.

B. Projects with project instructions

A Project is a workspace that holds related chats, files, and one set of instructions that apply to every chat inside it. Projects are available on Free, Plus, Go, Pro, and Team plans, with smaller file caps on Free.

  1. In the ChatGPT sidebar, click Projects, then New project. Give it a descriptive name.
  2. Open the project, click the three dots in the upper right, and select Project settings to add project instructions. These override your global custom instructions inside the project.
  3. Add reference files with Add source. You can upload PDFs, spreadsheets, docs, and images, or paste text. Files added to the project are available to every chat in it.

Test it. Start a new chat inside the project and give it a task. The instructions and files apply automatically. Confirm the output follows your rules.

Share it. Share the project with teammates by email. Personal memories are disabled in shared projects.

Tool guide

Google Gemini

Google's feature is called Gems. A Gem is a saved custom version of Gemini with its own name, instructions, and optional knowledge files. Gems are free on every Gemini plan.

  1. On your computer, go to gemini.google.com.
  2. Click Open Sidebar, then click Gems. If you have never made a Gem, first click Settings and help, then Gems.
  3. Click New Gem.
  4. Enter a name and write instructions for the Gem to follow. Provide your goals, the behavior you want, and the output format.
  5. Optional. To have Gemini expand rough notes into full instructions, type a short goal and click Use Gemini to re-write instructions, or click the wand icon. Review and edit what it produces.
  6. Optional. Under Knowledge, click Add files to attach reference material from your device or Google Drive. Adding files from Drive requires Google Workspace connected to Gemini.
  7. Click Save.

The minimum you need is a name and clear instructions. Knowledge files are optional.

Test it. Use the preview panel on the right. Enter a prompt, review the response, and edit the instructions. The preview does not save automatically, so click Save after you make changes.

Share it. Gems are private to your Google account by default. Inside Gemini for Workspace, click Share and choose specific email addresses, everyone in your organization, or a public link. There is no public Gem marketplace.

Optional

GitHub Copilot custom instructions

This one is for teams that keep work in a code repository. It is a developer tool, so most non-developers can skip it. It is included because the instruction file is simple and readable.

GitHub Copilot reads a plain-Markdown file named .github/copilot-instructions.md at the root of a repository. There is no YAML frontmatter and no special syntax. You write natural-language rules, Copilot detects the file automatically, and the rules apply to Copilot Chat and code review in that repository. Because the file lives in the repo, it is version-controlled and shared with everyone who pulls the branch, with no per-person setup.

Cursor uses a similar idea with its own rules files. Both are built for coding work. A general business skill belongs in Claude, Microsoft Copilot, ChatGPT, or Gemini.

Troubleshooting

When the skill does not behave

The skill does not trigger. The description is almost always the cause. Rewrite it to be specific and to name the trigger words and file types. In Claude, make it slightly pushy about when to apply.

As a fallback, name the skill directly in your request, for example "Use my weekly report skill". In Claude and Microsoft Cowork, confirm the skill is toggled on and that code execution or the required setting is enabled.

The output is inconsistent. Add specificity to the instructions and include validation steps the AI can self-check against. Paste a real example of good output so the AI has a target. Test triggering and output separately, so you know which one is failing.

The skill or instructions are too long. Trim to the steps that matter. Microsoft's Copilot instructions field caps at 8,000 characters, and the custom GPT instructions field caps at 8,000 characters. If you hit a limit, move long reference material into a knowledge file and keep the instructions to the procedure.

It uses the wrong knowledge. Check that the right files or SharePoint sources are attached and that permissions let the AI read them. Ask the AI to list the files it can see before you rely on it.

It does too much or acts on things you did not intend. Only load skills from sources you trust. A skill is instructions the AI follows, so a skill from an unknown source can direct the AI in ways you did not expect. Read the full text of any skill before you install it.

One-page checklist

Before, during, and after the build

Before you build

  • Picked one task I do at least weekly with a repeatable shape.
  • Wrote the steps as I would explain them to a new hire.
  • Noted the decisions I make and the rule for each.
  • Noted the source files and systems.
  • Wrote what "done" looks like and how I check it.

When I build the skill

  • Short, descriptive name.
  • One-sentence description that names when to use it and the trigger words.
  • Numbered steps.
  • Inputs listed.
  • Output format described.
  • One real example of good output.
  • Short list of things to avoid.

By tool

  • Microsoft 365 Copilot. Created an agent via New agent, filled Instructions and Knowledge, tested on Try it, shared or submitted to org catalog.
  • Claude. Enabled Skills and code execution, built via skill-creator or uploaded, tested with explicit and implicit prompts, shared if on Team or Enterprise.
  • ChatGPT. Built a custom GPT or a Project with project instructions, tested in preview, shared. Checked the GPT retirement timeline.
  • Gemini. Created a Gem with name and instructions, tested in preview, saved, shared if needed.

After I build

  • Ran a real task through it.
  • Fixed the description if it did not trigger.
  • Added a validation step if output was inconsistent.
  • Used it for two weeks and refined it.
Recommendations

What to do first

  1. Start with the documentation. Spend the first hour writing the task down using the "how to write the skill from your own work" section. If you cannot write clean steps yet, the process is not ready, so standardize it first. This is the point where most skills succeed or fail.
  2. Pick the tool you already pay for. If your company runs on Microsoft 365 with Copilot, use the agent builder in path A. If you use Claude, use skill-creator. If you use ChatGPT, use a Project. If you are in Google Workspace, use a Gem. Do not add a new subscription to build one skill.
  3. Build one skill, use it for two weeks, then build the next. Live with the first skill on real work before you scale. Fix the description when it does not trigger, and add a validation step when output drifts.
  4. On ChatGPT, prefer Projects over new custom GPTs for anything you want to keep past 2026. Custom GPT creation is planned to end September 25, 2026, with retirement December 11, 2026. If you already rely on a custom GPT, record its instructions and files now so you can move to a Plugin or a Project.
  5. On Microsoft, default to the agent builder and treat Cowork Skills as a second step. The agent builder is available to more users and needs no extra billing setup. Move to Cowork Skills or Copilot Studio only when you need the SKILL.md file format or advanced connectors, and confirm the license and billing first.
  6. Check licensing before you promise a rollout. The usual blockers are a paid ChatGPT plan for custom GPTs, code execution enabled for Claude Skills, and a Microsoft 365 Copilot license with usage-based billing for Cowork Skills. Confirm these with whoever owns the tenant before you build for a team.

What would change these recommendations. If Microsoft moves the "Skills" Customize feature into the main Copilot Chat app, path B becomes as easy as path A and should be promoted. If OpenAI ships its Plugins replacement with a clear no-code builder before the December 2026 retirement, revisit whether ChatGPT Projects is still the safer default.

FAQ

Frequently asked questions

What is a skill?

A skill is a written, reusable set of instructions for one task you do often, saved so an AI assistant follows the same steps every time. Claude and Microsoft 365 Copilot both call it a Skill and both use a SKILL.md file. ChatGPT uses custom GPTs and Projects. Google Gemini uses Gems.

Which tool should I build my skill in?

The tool you already pay for. On Microsoft 365 with Copilot, use the agent builder. On Claude, use skill-creator. On ChatGPT, use a Project. In Google Workspace, use a Gem.

Why does my skill not trigger?

The description is almost always the cause. Rewrite it to be specific and to name the trigger words and file types. As a fallback, name the skill directly in your request.

Should I build a custom GPT in ChatGPT?

For anything you want to keep past 2026, prefer a Project with project instructions. OpenAI plans to end creation of new custom GPTs on September 25, 2026 and to retire them on December 11, 2026, and describes those dates as targets subject to change.

Caveats

What this guide cannot promise

  • Product names, menus, and limits in these tools change often. Everything here was checked against official documentation as of September 15, 2026. Re-verify menu paths before a large rollout.
  • The exact numeric character limits for a Microsoft Cowork skill's name and description are not published in Microsoft's own documentation. Third-party guides cite figures from the Claude Skills spec, and those sources disagree. Do not treat a precise cap as confirmed.
  • The ChatGPT retirement dates are described by OpenAI as targets and plans, and OpenAI states they are subject to change and may not reach every workspace at the same time. Treat them as planning guidance.
  • Some sources used for context and framing are vendor blogs and third-party guides. Where a fact came only from those, it is noted or omitted. The step-by-step instructions rely on official documentation from Microsoft Learn, the Claude Help Center and platform docs, the OpenAI Help Center, and Google support.
  • Claude Code and GitHub Copilot instruction files are developer tools. They are included for completeness. A non-developer building a general business skill should use one of the four main paths above.
Sources