Updated November 2, 2026. Features and plan availability were checked against Google’s, OpenAI’s, and Anthropic’s help pages this month. These products change quickly, so confirm the details in your own account.
If you’ve been pasting the same brief into an AI chat every Monday, you already know the problem. The client’s tone guide, the banned words, the report format, the checklist you always forget: you type it again, the AI drifts anyway, and the output needs fixing. Skills solve that. A skill is a saved folder of instructions and reference files that your assistant loads when a task calls for it.
This guide shows you how to build AI skills for freelancers that you can reuse across clients in Gemini, ChatGPT, and Claude. You’ll get a copyable SKILL.md template, three ready-to-adapt client skills, and the exact menus to use on each platform. If you still rely on custom GPTs or Gemini Gems, this is also the rebuild you need before they go away. Our news post on custom GPTs and Gemini Gems being retired covers the dates.
Quick Answer: Write each repeat task as a folder containing one SKILL.md file: a short name, a description that says exactly when to use it, and step-by-step instructions, plus any reference files such as a style guide or template. Build one skill per job (client voice, proposal, report, editing checklist), not one giant assistant per client. Gemini and Claude let you upload that folder or a .zip directly, and ChatGPT uses the same SKILL.md structure, so one well-written skill can move between all three with light edits. Keep confidential client data out of the skill itself and test it on three real tasks before you rely on it.
What an AI Skill Is (and Why It Beats Saved Prompts)
A skill is not a separate chatbot. Custom GPTs and Gems made you leave your chat and open a dedicated assistant. A skill works inside whatever conversation you’re already in. You can call it by name, and the assistant can also pick it up on its own when your request matches the skill’s description. You can use several in one chat, for example a client voice skill and an SEO checklist skill on the same draft.
Under the hood, all three platforms build on the same simple format: a folder with a SKILL.md file that starts with a short header (a name and a description) followed by plain-language instructions. The format was developed by Anthropic and released as an open standard. Google says Gemini can import SKILL.md files made on other platforms, and OpenAI’s skill-building docs use the same name-and-description header.
For freelancers, three things make skills better than a notes file full of prompts:
- They load only when needed. The assistant reads the short description first and opens the full instructions only for matching tasks, so you can keep many skills without cluttering every chat.
- They carry files. A skill can include the client’s style guide, a report template, or a sample of approved work.
- They’re portable. A skill is just text and files, so you own it. You can back it up, version it, and move it if you switch assistants.
Skills on Gemini, ChatGPT, and Claude at a Glance
| Gemini | ChatGPT | Claude | |
|---|---|---|---|
| Who can use it | Personal Google accounts, 18+; no AI subscription needed. Work and school accounts are coming. | OpenAI says personal skills are generally available on Business, Enterprise, Healthcare, and Edu. Check your account on other plans. | Free, Pro, Max, Ultra, Team, and Enterprise, with code execution turned on |
| Where to create | Customize > Skills | Skills in the desktop app sidebar, or ask the @skill-creator | Customize > Skills |
| Upload a SKILL.md or .zip | Yes, on web and Mac | Check the vendor’s site | Yes, as a .zip |
| How to call one | Type / (or @) and pick it, or let Gemini apply it | Type @ and pick it, or let ChatGPT apply it | Claude applies it based on the description |
| Key limits | 100 MB of files per skill; 100 active skills | Check the vendor’s site | Name up to 64 characters; description up to 200 characters |
| Sharing | Not yet (Google says coming soon) | Share a plugin that bundles your skills | Team and Enterprise plans |
Table: Checked November 2, 2026, against each vendor’s help center. Plan availability is rolling out and may differ in your account.
Step 1: Decide Which Client Tasks Deserve a Skill
Not every task needs one. A skill pays off when a job is repeated, has rules you keep restating, and has a clear finished format. Look back over the last month of work and list anything you did three or more times.
- Pick tasks with fixed rules. Client tone of voice, house style, banned claims, legal phrases, and formatting all belong in a skill.
- Pick tasks with a fixed output. Weekly reports, proposals, social post sets, meeting summaries, and invoice emails all have a shape you can describe.
- Skip one-off creative work. A brand-new campaign concept changes every time, so a saved skill won’t help much.
- Split by job, not by client. Instead of one “Acme assistant”, build “acme-voice” plus a general “weekly-report” skill. Stack them in the same chat when you need both.
A good starter set for most freelancers is four skills: one voice skill per major client, a proposal skill, a client report skill, and a final-edit checklist skill.
Step 2: Write the SKILL.md File
Everything starts with one text file named SKILL.md inside a folder with the same name as the skill. The header between the two lines of three dashes holds the name and description. Everything below it is the instruction set.
Follow these rules so the file works on all three platforms:
- Name: lowercase letters, numbers, and hyphens only, such as
acme-brand-voice. Gemini requires lowercase with hyphens, Claude caps names at 64 characters, and the open spec says the folder name should match. - Description: one or two sentences that say what the skill does and when to use it. Claude’s help page sets a 200-character limit, so staying under that keeps the file portable.
- Instructions: numbered steps in plain language. The open spec recommends keeping SKILL.md under 500 lines and putting long material in separate reference files.
- Reference files: put them in a subfolder such as
references/and mention each one by name in the instructions so the assistant knows when to open it.
Here is a blank template you can copy:
---
name: client-task-name
description: Use when [trigger, e.g. writing blog posts for Acme]. Produces [output]. Do not use for [exclusions].
---
# [Skill title]
## When to use
- [Request type 1]
- [Request type 2]
## Steps
1. Ask for any missing inputs: [list them].
2. Read references/[file].md before drafting.
3. [Main task steps, in order.]
4. Check the draft against the rules below.
5. Return the result in the format below.
## Rules
- [Tone, banned words, required phrases]
- Never invent facts, quotes, prices, or statistics. Mark gaps as [CHECK].
## Output format
[Headings, length, file type, or a short example]
The description does the most work. The assistant reads it to decide whether to load the skill, so name the trigger words a client request would contain, such as “Acme”, “blog post”, or “newsletter”. Vague descriptions like “helps with writing” either fire on everything or on nothing.
Step 3: Copy and Adapt These Three Client Skills
These examples show how specific a useful skill should be. Swap in your client’s details.
Example 1: Client Brand Voice
---
name: acme-brand-voice
description: Use for any copy written for Acme Outdoor (blog, email, social, product pages). Applies Acme's voice, banned words, and claim rules.
---
# Acme Outdoor brand voice
## Steps
1. Read references/acme-style-guide.md and references/approved-samples.md.
2. Draft in Acme's voice: practical, warm, second person, short sentences.
3. Run the checklist below before returning the draft.
## Rules
- Use "you" and "your." Avoid "we're excited to."
- Banned words: revolutionary, game-changer, unleash, best-in-class.
- No environmental claims (e.g. "eco-friendly") unless they appear in references/approved-claims.md.
- US spelling. Oxford comma.
## Checklist
- Every product claim matches approved-claims.md.
- No banned words.
- Reading level roughly grade 7 to 8.
If you haven’t documented a client’s voice yet, our guide to training AI on your brand voice walks through collecting samples and writing the style rules that go into a skill like this.
Example 2: Proposal Builder
---
name: freelance-proposal
description: Use when drafting a proposal or quote for a new client project. Turns discovery-call notes into a one-page proposal in my standard format.
---
# Proposal builder
## Steps
1. Ask for: client name, project goal, deliverables, deadline, budget range.
2. Read references/proposal-template.md and references/rates.md.
3. Fill the template. Price only from rates.md; if a deliverable is not listed, write [PRICE TBC].
4. Add three clarifying questions the client should answer before kickoff.
## Rules
- One page. Plain language. No guarantees of results.
- Always include the revision policy and payment terms from the template.
Pair this with the tools in our guide to AI proposal software for freelancers if you also need e-signatures and tracking.
Example 3: Weekly Client Report
---
name: weekly-client-report
description: Use when I paste weekly metrics or task notes and ask for a client update or status report.
---
# Weekly client report
## Steps
1. Sort the notes into: Done, In progress, Blocked, Next week.
2. Pull out up to three numbers that changed and say what each means in one sentence.
3. Write a 3-sentence summary at the top a busy client can read in 20 seconds.
## Rules
- Report only numbers present in my notes. Never estimate or round up.
- Flag anything blocked on the client in bold with a date I need it by.
## Output format
Subject line, summary, four short sections, one closing line. Under 250 words.
Step 4: Add It to Gemini
Google’s Create and manage skills help page lists these steps for the Gemini web app:
- Go to gemini.google.com and select Customize in the sidebar (click More first if you don’t see it), then Skills.
- Choose Create manually to type a name, description, and instructions, Create with Gemini to build one through chat, or Upload to add your SKILL.md, the folder, or a .zip with SKILL.md in its main folder.
- Add reference files with Add. Sources include your device, Google Drive, and Google Photos. The total for all files can’t exceed 100 MB.
- In any chat, type / (or @ if you have the updated shortcut) and pick the skill, or just describe the task and let Gemini apply an active skill.
A few things to know. Google’s Gems-to-skills FAQ says uploading files to create skills currently works only on the web and Mac apps, skills don’t yet work with Canvas, Deep Research, and some other tools, and sharing is promised “in the coming weeks.” To change a skill’s files, you upload the whole skill again. Bundled scripts can’t reach the internet, and older .doc, .xls, and .ppt files, audio, video, and archives inside a skill aren’t supported. You’ll also need Keep Activity turned on.
Step 5: Add It to ChatGPT
ChatGPT handles skills a little differently, because OpenAI packages them inside plugins for sharing. According to OpenAI’s plugins help page, “Personal Skills are generally available to ChatGPT Business, Enterprise, Healthcare, and Edu users,” and availability also depends on workspace settings and the app you’re using. If you’re on another plan, check your sidebar for Skills before planning around it.
- Open Skills in the ChatGPT desktop app sidebar, or ask ChatGPT’s built-in @skill-creator to build one. OpenAI’s build skills docs say it asks what the skill does, when it should trigger, and whether it needs scripts.
- Paste in your SKILL.md content or answer the creator’s questions using your template.
- Call the skill by typing @ and selecting it, or let ChatGPT apply it when your request matches the description.
- To give a client or teammate access, package skills in a plugin, then use Share plugin from the plugin’s menu and choose who has access.
OpenAI notes that skills in ChatGPT and in its Codex agent “may need to be managed separately,” so keep your master copy outside both. Exact upload steps were not available on OpenAI’s Skills in ChatGPT page when we checked, so follow the prompts in your account. If you’re still deciding which assistant should be your main one, see our ChatGPT alternatives guide.
Step 6: Add It to Claude
Anthropic’s skills help page says skills are available on Free, Pro, Max, Ultra, Team, and Enterprise plans, and they require code execution.
- On individual plans, go to Settings > Capabilities and turn on code execution and file creation. On Team and Enterprise, an owner controls this in organization settings.
- Zip your skill folder so the folder itself sits at the root of the .zip (for example,
acme-brand-voice.zipcontainingacme-brand-voice/SKILL.md). - Go to Customize > Skills, click +, then Create skill, then Upload a skill, and select the .zip.
- Turn the skill on and test it with a few prompts. Claude decides when to use a skill from its description, so rewrite the description if it doesn’t load when expected.
On Team and Enterprise plans you can share a skill with specific people (they get view-only access and receive updates), and Enterprise admins can publish skills to the whole organization. Anthropic’s custom skills guide covers the file structure in more detail. For a broader view of where Claude fits, see our Claude alternatives roundup and ChatGPT vs Claude comparison.
Step 7: Test, Version, and Maintain Your Skills
A skill that works once can still fail on the fourth request. Treat each one like a client template you maintain.
- Test with three real tasks. Use past briefs where you know what good output looks like. Check tone, format, and whether the skill loaded at all.
- Test the trigger. Ask a related question that should not use the skill and make sure it stays out of the way.
- Keep a master copy. Store every skill folder in one place on your computer or cloud drive, with the date in a changelog line at the bottom of SKILL.md.
- Update after feedback. When a client corrects something twice, add it as a rule in the skill rather than fixing it by hand each time.
- Retire stale skills. When a contract ends, deactivate or remove that client’s skills so they can’t leak into other work.
Once your skills are stable, you can chain them into a larger process. Our guide on automating your content workflow with AI shows where skills fit alongside scheduling and handoff tools.
What This Means for Client Work
Protect client data. A skill file can be shared, exported, or uploaded to the wrong account. Keep passwords, API keys, contract terms, and personal data out of it. Anthropic’s help page specifically warns against hardcoding sensitive information. Put only what the AI needs to do the task.
Decide who owns the skill. If you build a skill as a paid deliverable, say in your contract whether the client gets the files and whether you can reuse the general structure for others. The client’s style guide is theirs; your proposal workflow is yours.
Only install skills you trust. Skills can include scripts. Anthropic tells users to install skills only from trusted sources and to review bundled files. Read any skill a client or marketplace sends before turning it on.
Price the setup, not just the output. A good skill set can cut hours from recurring work, so consider billing skill setup as a one-time onboarding fee rather than giving it away. For more ideas on reclaiming time, see how to use AI for freelancing.
Common Mistakes to Avoid
Mistake 1: Building one giant skill per client. A 2,000-word instruction file covering every task confuses the assistant and is hard to update. Split by job and stack skills when you need more than one.
Mistake 2: Writing a vague description. The description decides when a skill loads. Name the client, the task, and the output, and say what the skill is not for.
Mistake 3: Letting the AI fill gaps. If a skill doesn’t tell the assistant what to do when information is missing, it may make something up. Add a rule like “Mark missing facts as [CHECK].”
Mistake 4: Keeping your only copy inside the app. The GPT and Gem retirements show that platform features change. Keep the master folder yourself.
Mistake 5: Skipping the test run. Skills can behave differently on each platform. Run the same test tasks in each tool before using a skill on paid work.
Frequently Asked Questions
What are AI skills?
An AI skill is a saved folder with a SKILL.md instruction file and optional reference files. Your assistant loads it when a task matches its description, so you don’t have to repeat the same brief in every chat.
Can I use the same skill in Gemini, ChatGPT, and Claude?
Usually, with light edits. All three use the SKILL.md structure with a name and description header. Keep names lowercase with hyphens and descriptions under 200 characters to stay within each platform’s rules. Features that depend on one platform’s tools, such as scripts or app connections, may not carry over.
Are AI skills free?
Google says Gemini skills don’t require a Google AI subscription. Anthropic lists skills on Claude’s Free plan as well as paid plans. In ChatGPT, OpenAI lists personal skills as generally available on Business, Enterprise, Healthcare, and Edu, so check your account on other plans.
How are skills different from custom GPTs and Gems?
GPTs and Gems were separate assistants you had to open. Skills work inside any chat, can be combined, and use a portable file format. OpenAI is replacing custom GPTs with plugins and skills, and Google is replacing Gems with skills.
Is it safe to put client information in a skill?
Put in only what the task needs, such as tone rules and approved claims. Leave out passwords, keys, and personal data, and check your client contract before uploading their materials to any AI tool.
How many skills should a freelancer have?
Start with three to five: a voice skill for each main client, a proposal skill, a report skill, and an editing checklist. Add more only when a task repeats often.
You May Also Like
- Custom GPTs and Gemini Gems Are Being Retired: What Freelancers Need to Do
- How to Train AI on Your Brand Voice (Step-by-Step)
- How to Automate Your Content Workflow with AI (2026 Guide)
- The Freelancer’s Complete AI Toolkit (2026 Edition)
- GPT-6.1 Terra: What OpenAI’s New Model Means for Freelancers
- ChatGPT Alternatives: 7 Tools for Different Workflows (2026)
- How to Protect Client Data When Using AI Tools




