Create & manage skills for Gemini Apps

Important:Skills are currently only available in Gemini Spark. Learn more about Gemini Spark .

You can use skills to create and save custom instructions that can be used across your tasks. Instead of re-typing your preferences or uploading the same files. Spark can use relevant skills in the background or you can specify a skill to use for your task or workflow.

With skills, you can:

Save time and effort:Build a skill once and use it in any Gemini Spark task.
Automate your workflow:Gemini automatically recognizes when a skill is relevant to your current prompt and applies it for you.
Mix and match skills:Use multiple skills for a single task to handle more complex work exactly the way you want. You can even use skills with other skills.

What you need

To create and use skills, you must:

Be 18 or over and in the US.
Sign in to the Gemini appwith a personal Google Account with a Google AI Ultra subscription. Learn how to upgrade .
Have Keep Activity on.

Important:For now, skills are:

Only available in English.
Only available in Gemini Spark in the Gemini mobile app and the Gemini web app at gemini.google.com .

Create a skill

You can create a skill from the Skills page or in a Spark task. On the Skills page, you can create a skill with help from Gemini, build one from a prefilled or blank template, or upload a skill file.

Tip:You can reference other skills within your skill instructions to build more complex workflows.

Step 1: Go to the Skills page

On your computer, go to gemini.google.com .
On the sidebar, click Change mode Switch to Spark Skills.

Step 2: Choose how you want to create a skill

Work with Gemini to create a skill

On the Skills page, at the top, click Create with Gemini.
Follow the instructions in the task thread.

Edit a prefilled template to create a skill

On the Skills page under “Recommended,” find a skill template you want to use.
On the template, click Add skill. This saves the skill to your “Active” list.
Under “Active,” click the skill.
Make your edits to the name, description, and instructions.
When you’re done, at the top, click Save.

Use a blank template to create a skill

On the Skills page, at the top, click Create manually.
Enter the name of your skill, a description of what it does, and instructions for it to follow.
When you’re done, at the top, click Save.

Upload a file to create a skill

Important:For now, scripts that require access to the internet are not supported.

On the Skills page, at the top, click Upload .
Select a SKILL.md file or a .zip file that contains a SKILL.md file in the main folder.
Click Open.
Review the skill and make any edits you want to make.
When you’re done, at the top, click Save.

Upload requirements

Supported File Types

You can upload plain-text based files. If you can open it in a basic text editor and read it, it is likely supported.

Supported:
- Text & Docs: .txt , .md , .rst , .rtf , .tex , .log
- Code: .py , .sh .
- Data & Config: .json , .yaml , .csv , .toml , .xml , .env, .sql
- Web & Build: .html , .css , .svg , Makefile , Dockerfile
Not supported:
- Binary/Rich Media: .pdf , .docx, .doc , .xlsx, .jpg , .png , or any other non-plain-text formats or image types.

Structure & Naming

Skill Metadata: Your project must include a SKILL.md file located in the root (main) folder.
Naming Convention: The skill name inside SKILL.md must use all lowercase with words separated by a hyphen (such as my-new-skill ).
Size Limit: The total size of all uploaded files must not exceed 100 MB.

Security Restrictions

No External Actions: Scripts can’t perform actions or requests on external websites.

Tip:Before you upload, check for hidden binary files (like .DS_Store or .pyc) that might cause the upload to fail.

Ask Gemini to create a skill in a Spark task

On your computer, go to gemini.google.com .
On the sidebar, click Change mode Switch to Spark Tasks.
In the text box, ask Gemini to create a skill and describe what you want the skill to do.
- For example, Create a skill based on these instructions: <your instructions>
Click Submit. Gemini will create your skill and save it to your Skills page.
To make edits to the skill, just describe your edits in the thread

Tip: You can’t activate, deactivate, or delete a skill from a task. To perform those actions, on the sidebar, click Skills

Explore skill examples

Skills can automate a wide range of tasks and workflows:

Writing help: A skill can help with homework and have specific instructions not to give answers. It can include your past papers, feedback, and scores.
Brainstorming:A skill can expand on ideas and then generate a design document based on a standard template.
Tactical support:A skill can help with specific tasks, like converting bank statements into formatted spreadsheets or generating product descriptions for a website.
Career guidance:A skill can give advice on job opportunities based on your resume.

Use skills for a task

Skills are designed to work in the background and can be used across Agent tasks. You can ask Gemini to use specific skills for a task. Gemini can also automatically use a skill when it’s relevant to your task.

Ask Gemini to use a skill:In the task thread, enter / or @, then select the skill.
Gemini automatically uses skills: Gemini can automatically use skills that are turned on based on the context and intent of your task.
Combine skills: You can include multiple skills for Gemini to use in a single task. This helps Gemini complete complex, multi-step tasks effectively.

Manage your skills

You can manage your skills from the Skills page in the Gemini web app.

Manage Gemini’s automatic use of a skill

Gemini can only automatically use skills that are turned on. You can turn skills off at any time. If a skill is off and you ask Gemini to use it, Gemini will ask you if you want to turn it back on.

To stop Gemini from using a skill automatically:

On your computer, go to gemini.google.com .
On the sidebar, click Change mode Switch to Spark Skills.
Click the skill that you want Gemini to stop using.
At the top, click More Deactivate.

To allow Gemini to automatically use a skill again, follow the same steps and click Activate

Edit a skill

On your computer, go to gemini.google.com .
On the sidebar, click Change mode Switch to Spark Skills.
Click the skill you want to edit.
1. To edit directly, update the "Description" and "Instructions" fields.
2. To edit conversationally, click More Edit with Gemini.
Make your edits.
- Alternatively, to upload a file to replace a skill, click More Replace skill.
When you’re done, at the top, click Save.

Tip: In an Spark task thread, you can also ask Gemini to update a skill and its files.

Delete a skill

Important:If you delete a skill, it can’t be undone.

You can only delete a skill from the Skills page.

On your computer, go to gemini.google.com .
On the sidebar, click Change mode Switch to Spark Skills.
Hover over the skill you want to delete.
Click More Delete.

Download a skill

On your computer, go to gemini.google.com .
On the sidebar, click Change mode Switch to Spark Skills.
Hover over the skill you want to download.
Click More Download. This downloads your skill in a .zip file.

Common questions

What's the difference between a task, schedule, and skill?

To help you get the most out of Spark tasks, it’s helpful to understand the three building blocks that power its logic: tasks, schedules, and skills. Think of these as the what, when, and how.

A task is your high-level goal.It represents a complete project or objective you want Gemini Spark to manage for you.

Example: "Plan and manage my business trip to London."

A schedule lets you hand over tasksto Gemini Spark so they run automatically in the background. You tell Gemini what to do and when to do it. Tasks can be scheduled to run at a specific date and time or in response to an event.

Example:"Every day at 8AM (condition), give me an update on AI news (task)"
Example:"When my flight is delayed (condition), notify me and propose an update to my itinerary (task)."

Tip: Schedules in Gemini Spark are different from scheduled actions in Gemini chat. Learn how to schedule actions in Gemini Apps .

A skill is a set of reusable instructions and additional context.It teaches Gemini how to do a specific task and what tools to use. You can specify the skill Gemini Spark should use for a task or a schedule’s action. Spark can also automatically use a skill when it’s relevant to a task.

Example:Using a "Travel Booking" skill and a "Gmail Writing" skill simultaneously to rebook a room and send a confirmation.

In summary, you define the task (what you want), set the schedules (when it should happen), and provide the skills (how to do it) to complete the work.

Related resources

Computer Android iPhone & iPad