Skip to main content

Create a Skill

From Skills, click Create. To start from an existing skill instead, choose Duplicate from its menu; the copy starts as a draft.
Creating and managing skills requires the Editor role or above.
Write the skill by hand, or draft it with the Skill Builder: describe the scenario or attach an existing process doc, and it suggests content in the chat; applying it is up to you. Either way, the skill takes shape in SKILL.md: the frontmatter carries its name, description, and other metadata, and the body holds the procedure itself.
The following settings shape how the skill is found and used:
  • Names: after a skill is published, renaming it changes only the display-name.
  • Description: state what the skill does and when an agent should use it.
  • Metadata: to keep extra information with the skill, add custom frontmatter fields.
  • Supporting files: if the task needs more than instructions, add templates, scripts, or reference docs through the file tree.
  • Tags: add them from the editor sidebar, then filter by tag on the Skills page. They’re for organizing the library only. Changes to tags take effect without publishing.
When the skill is ready, publish it to make it available to agents.

Publish and Versions

Your edits autosave as a draft and reach agents only when you publish. Each publish is saved as a version you can revisit or restore later.
Restoring a version publishes it immediately as the newest version.

Add to Agents

From Agents, open the agent’s Configure page. Under SKILLS, click Add and choose From skill library. The agent follows the skill’s latest published version from then on, and decides when to use it by its name and description. You can also add skills in a workflow’s Agent node.

Import a Skill

To bring in a skill built elsewhere, click Import on the Skills page and choose a .zip or .skill package in the Agent Skills format. The package arrives as a draft for you to review and publish. To turn an agent’s embedded skill into a library skill, import its package here.

Export a Skill

To take a skill beyond this workspace, choose Export from the menu on its card in Skills. You get the skill’s latest published version as a .zip package in the Agent Skills format.

Delete a Skill

Deleting a skill removes it from the workspace and from every agent that uses it, along with all of its versions. A deleted skill can’t be recovered; export a copy first if you may need it again.
Last modified on July 29, 2026