Skip to content

armgit / zed

Public Imported from GitHub
0

Code at the speed of thought – Zed is a high-performance, multiplayer code editor from the creators of Atom and Tree-sitter.

docs: Add Skills settings documentation (#57273)

María Craigbb63046a0855
diff --git a/docs/src/ai/skills.md b/docs/src/ai/skills.md
index 25ffebc9728..73d8712b44f 100644
--- a/docs/src/ai/skills.md
+++ b/docs/src/ai/skills.md
@@ -11,11 +11,13 @@ A skill is a folder containing a `SKILL.md` file with metadata and instructions.
## Adding Skills {#adding-skills}
-### Create Your Own {#create-your-own}
+### Create your own {#create-your-own}
-Zed includes a built-in `create-skill` skill that guides the agent through creating a new skill. Invoke it with `/create-skill`, or let the agent pick it up automatically when you ask it to help create a skill.
+Zed includes a built-in `create-skill` skill — invoke it with `/create-skill` and the agent walks you through the process.
-See [Skill format](#skill-format) below for the folder structure and `SKILL.md` reference.
+You can also open the Skill Creator directly with the {#action agent::OpenSkillCreator} action. It opens a window where you fill in the skill's name, description, scope (global or project-local), body, and optionally toggle `disable-model-invocation`.
+
+See [Skill format](#skill-format) below for the full format reference.
### From the skills.sh Registry {#from-the-registry}
@@ -38,6 +40,19 @@ git sparse-checkout set frontend-design
For a project-local install, do the same inside your project's `.agents/skills/` folder.
+## Managing Skills {#managing-skills}
+
+Open the Settings Editor (`Cmd+,` on macOS, `Ctrl+,` on Linux/Windows) and navigate to **AI > Skills**, or go directly to [agent.skills](zed://settings/agent.skills).
+
+The **User** tab shows your global skills. The **Project** tab shows skills for the current project.
+
+For each skill you can:
+
+- **Open** — opens the skill's `SKILL.md` file in the editor
+- **Delete** — removes the skill folder from disk
+
+If no skills are installed, the page shows a **Create a Skill** button that opens the Skill Creator.
+
## Using Skills {#using-skills}
By default, the agent picks up skills autonomously. It sees a catalog of every installed skill (name and description) in its system prompt, and calls the `skill` tool when a task matches a skill's description.