GeminiGemsLevel 2: Context

How Do You Create a Skill in Gemini?

Open Customize in the sidebar, click Skills, then Create. A skill is a saved set of instructions with a name and a description. Run it by typing / and its name in any chat, or let Gemini apply it automatically. It replaces Gems on personal accounts.

Prompt to copy
Click Customize > Skills > Create > Create manually, and paste:

Name:
write-weekly-client-update

Description:
Turns rough notes into a weekly client update with progress, blockers and next steps. Use when writing a status update, a client report or a weekly summary from notes.

Instructions:
1. Read the notes I provide.
2. Write these sections: Done this week, Blocked, Next week, Decisions needed.
3. Use short bullets in plain language. No internal names or ticket numbers.
4. If a section has nothing in my notes, ask me rather than guessing.
5. Common mistakes: inventing dates, and promising work I didn't mention.
  1. 1Name and descriptionchecked first
  2. 2Full instructionsread if relevant
  3. 3Attached filesopened only when needed
How Google says Gemini reads a skill: it checks the short part first, and opens more only when it's needed.
  • 100 MBTotal upload size
  • 1,024Description charactersthe limit in Google's guide
Source: Google's skills help and writing guide, checked November 6, 2026.

Try it now

  1. 1In the sidebar, click Customize (or More first if it's hidden), then Skills at the top.
  2. 2Click Create, then Create manually, paste the fields above, and click Create.
  3. 3In a new chat, type /, pick your skill, and paste some real notes. If your app has the updated shortcut, use @ instead.
  4. 4Then ask for a weekly update without naming the skill. You'll know the description works if Gemini applies it by itself.

Use it when

When you've typed the same setup three times: a weekly report layout, a house style, a method for turning bank statements into a spreadsheet. Google's examples include career advice based on your resume, and coursework help that gives hints instead of answers.

Skip it when

Work and school accounts don't have these skills yet, so use a Gem there. Docs and Gmail help also refers to skills made in Workspace Studio, which is a separate route. Skip a skill too if your job relies on tools Google says don't work with skills, such as Canvas, Deep Research, or video and music creation.

Why it works

Google's blog post of September 30, 2026, describes skills as reusable custom instructions you can run without retyping prompts. You can stack several in one chat, such as a writing style skill with a brand guidelines skill. Google says Gemini looks only at the name and description to judge whether one applies, then reads the instructions, then opens attached files only when needed. You need to be 18 or over and have Keep Activity on, but a Google AI subscription isn't required.

Example

Say you send three clients a Friday update. Without a skill, you retype the sections and the rules each week. With the one above, you paste Friday's notes after /write-weekly-client-update and get the same four sections every time. To add your layout, you can attach a template file, because Google's guidance is that files are opened only when they're needed. Then stack a brand voice skill on top when you want both.

Going further

A skill is portable. Use More > Download for a .zip, or Create > Upload to bring in a SKILL.md file, or a folder or .zip with SKILL.md in its main folder. The name must be lowercase with hyphens, and the total upload can't exceed 100 MB. Supported files include .md, .txt, .pdf, .docx, .csv, .xlsx, .py, .sh, .js, .json and .yaml. Not supported: .ts, .tsx, .jsx, .sql, legacy Office files, audio, video and archives. Scripts can't reach the internet, and hidden files like .DS_Store should be removed first.

Common mistakes

  • Writing a vague description. Gemini checks that before anything else, so a weak one means the skill never gets picked.
  • Trying to delete or turn off a skill from a chat. Google says you can only do that on the Skills page.
  • Deleting a skill to tidy up. That can't be undone. Use More > Deactivate to stop automatic use and keep it.
  • Assuming a download includes everything. Google says Drive files and notebooks aren't in the .zip.

Sources

Checked 6 November 2026. Products change often, so confirm details with the vendor.

Related

Beyond the course