Build a skill
Create a skill, write its instructions, and add the content and tools it uses.
All the steps presented below can be autonomously handled through your AI agent (Claude Desktop) and executed for you. See Author with AI.
A skill is instructions plus what they rely on.
Create the skill
On Capabilities > Skills, click Add Skill. Under Create from scratch, type a name and click Continue. Skilder opens the skill editor. Click Edit and describe what the skill does in its Description.
Write the instructions
SKILL.md is selected by default. Use Use Template for a structured starting point (Purpose, When to Use, Steps, Error Handling), or Start from scratch. Changes autosave.

Add content
Click Add file in the file tree and choose what to add.

| Kind | Name and fields | Notes |
|---|---|---|
| Reference | Name, and a type: Markdown, plain text, JSON, YAML, TOML, XML or CSV | The agent reads it on demand. A Markdown reference can be switched between Versioned and Live (unversioned) in its settings panel. |
| Script | Name, and a language: Python, JavaScript, TypeScript or Bash | Opens in a code editor. Use Test Script in its settings panel to run it with CLI-style arguments, once your workspace has a sandbox. A TypeScript script can import the script SDK to call tools and return a result. A Python script can declare the packages it needs: see Python dependencies. Any script can take files as arguments and return files: see Files in and out. |
| Asset | A file, dropped or browsed | A dropped text file is imported as a reference instead, automatically. A text file your agent attaches from disk becomes a reference the same way. |
Each item's settings panel carries a delete action at the bottom (Delete Reference, Delete Script or Delete Asset).
Connect tools
Select the skill root to see its Tools section, and click Manage Tools. Click an MCP server to list its tools. Tick the tools this skill needs, then click Update.

If the server you need is not installed yet, a skill with no tools offers Don't see tools? Add MCP Server, and the drawer offers Configure MCP Servers when the workspace has none. Both need admin rights.
Check it worked
The file tree lists what you added, and the Tools count on the skill reflects what you connected. The skill shows up on the Skills page, under Capabilities in the sidebar. Once a role carries it, the skill's Used by list names that role.
Next
- Create a role, to attach this skill to a role.
- Publish and version, to make it available to agents.

