Skip to main content

​
Opening the skill editor

  • Workspace-shared skills: Sidebar > Configure > Skills > “New skill”
  • Agent-specific skills: Agent’s configuration panel > Skills section > “Create new”
Open an existing skill with “Edit” from the list. On the Skills page, the editor opens as a drawer in card view; in list view it opens in a pane to the right of the list (on narrow screens, as a drawer). It is the same editor everywhere — the Skills page, an agent’s Skills section, and a skill chip in a chat message all open it, with the same fields, the same validation and the same save. Only the frame around it changes to fit the surface; the editor scrolls, and the instructions box fills the height it is given.

​
The editor

1

Fill in the frontmatter (metadata)

  • Name (required) — e.g., PDF Extract
  • Description — what this Skill does and when it should be invoked. Be specific: the AI uses this to decide whether to use the skill
  • Allowed tools (optional) — comma-separated tool names. Leave blank for no restriction
2

Write the body

Write the Markdown body on the “Edit” tab. Check how it looks on the “Preview” tab.
Enter the name and description, then press “Auto-generate body” to have the AI draft a body from what you have entered.
3

Choose where to save it

  • Workspace shared — attachable by every agent
  • This agent only — agent-specific (when created from the agent detail page)
You can change the location later (promote / demote). Creating a workspace-shared skill asks for a final confirmation (“Create new workspace skill?”) — other members will be able to see and use it, so make sure it contains nothing personal or private.

​
Importing an existing SKILL.md

When creating a skill, an import dropzone sits at the top of the form — “Drag a SKILL.md here,” or click it to browse. Pasting SKILL.md text into the editor works too.
  • The frontmatter (name, description, tools) and body are filled into the form automatically
  • Markdown files (.md) only, up to 1 MB each
A SKILL.md can also be registered from chat — attach the file to a conversation and ask the AI to register it (Create Skills from Chat).
On the workspace Skills page, dropping several files at once skips the form and immediately creates one workspace-shared skill per file — no per-skill confirmation. Make sure the files contain nothing personal or private before dropping them.

​
Editing shared skills, and forking

Editing a workspace-shared skill affects every agent it is attached to.
To adapt a shared skill for a specific agent, fork it first: open it from that agent and press “Copy and edit for this agent only” on the warning banner in the editor. The editor stays open and switches to the copy, carrying any edits you had already typed, so you can keep working without losing your place. The original skill is unaffected.

​
Deleting

Delete from the editor or from the list; the confirmation names the agents the skill is attached to. Deleting an agent-specific skill cannot be undone. The editor opened from a skill chip in a chat message does not offer “Delete” — delete from the Skills list or from the agent’s Skills section instead.

​
Writing tips

  • One skill, one purpose — split multiple procedures into separate skills instead of cramming them into one
  • The description is everything — the AI reads the description to decide “should I use this skill now?” Spell out “use this when …”
  • Number your steps — explicit ordering and conditions are more reliable than vague phrasing