- 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.

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.
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.
.mdfile: Must contain the skill name and description formatted in YAML..zipor.skillfile: Must include aSKILL.mdfile.
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.