Create and Edit Skills

Using the skill editor — writing by hand, auto-generating, and importing

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, creating and editing happen in a pane to the right of the list (on narrow screens it opens as a drawer).

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

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 with “Copy to this agent and edit” in the editor, then make your changes. The original skill is unaffected.

Deleting

Delete from the editor or from the list. Deleting an agent-specific skill cannot be undone.

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