Skip to main content
Skills are created on the Skills page. To open it, expand the More group in the left navigation and click Skills. For an overview of the page, see The Skills page. There are three ways to create a skill:
  • Write skill instructions: Fill in the skill’s details and instructions yourself.
  • Upload a skill: Import a skill file or package you already have.
  • Generate skill with AI: Describe what the skill should do, and AI drafts it for you. To start, click Create Skill in the top-right corner of the Skills page, or click the Create skill card at the end of your skills.

Write skill instructions

1

Open the 'Write skill instructions' window

Click Create Skill, then choose Write skill instructions.
2

Fill in the skill details

Complete the following fields.
3

Choose trusted access

Select Grant trusted access to allow the skill’s scripts, such as .py or .sh files, to run in the sandbox. Untrusted skills can still use their documentation and data files, but their code won’t run. Only enable this for skills from verified, trusted sources.
4

Set the status

The Active toggle at the bottom of the window is on by default, so the skill is available as soon as you create it. Turn it off to save the skill without making it available yet.
5

Create the skill

Click Create. The skill is added to My skills in your workspace.
Write skill instructions window showing Skill name, Icon, Description, and Instructions fields, the Enhance with AI button, the Grant trusted access option, and the Active toggle.

Expanded editing

For longer instructions, you can give yourself more room to write.
  • Full screen: Click the expand icon in the top-right corner of the window to fill the screen.
  • New tab: When editing a skill, click Open in new tab to work on it in its own browser tab.
Save and autosave work the same in every view, so nothing you write is lost when you switch.

Upload a skill

1

Open the 'Upload skill' window

Click Create Skill, then choose Upload skill. You can also click Upload skill in the top-right corner of the Write skill instructions window.
2

Add the file

Drag and drop a file into the upload area, or click to browse your files. The following file types are supported.
  • .md file: Must contain the skill name and description formatted in YAML.
  • .zip or .skill file: Must include a SKILL.md file.
3

Upload the skill

Click Upload. The skill is added to My skills in your workspace.

Generate a skill with AI

1

Open the 'Generate skill with AI' window

Click Create Skill, then choose Generate skill with AI.
2

Describe the skill

In What should this skill do?, describe the task in plain language. For example, “Summarize sales call transcripts into five bullet points with owners and due dates for each action item.”
3

Generate and review

Click Generate skill. AI drafts the skill’s name, description, and instructions, then opens the skill in the editor so you can review it.
Generated skills are created active but untrusted. To check a generated skill before anyone uses it, turn off Active in the editor until you’re ready.

Edit a skill

Open a skill from My skills to change it in the Edit skill window. It has the same fields as Write skill instructions, plus the following options in the top-right corner.
  • Open in new tab: Edit the skill in its own browser tab.
  • Download: Save a copy of the skill file to your computer. Click Update to save your changes. Every chat and project that uses the skill gets the updated version.