Skills are modular instructions that extend what an agent knows how to do. Each skill is a Markdown file that describes a capability, such as reviewing code or running a project’s test suite. When a request matches a skill’s description, the agent loads the full instructions and follows them.
Manage skills
In the desktop app, open Settings > Skills. Choose Global for your personal skills or a project from the scope menu for its skills.
- Use Open Folder in Zed to add a skill in the selected scope.
- Use a skill’s Open in Zed button to edit its
SKILL.md. - Skills that couldn’t load show their path and error. Open the file in Zed to fix it.
- Use Delete Skill and confirm to move the entire skill folder to the Trash, including supporting files. This also removes it from other agent tools that use that location.
The Skills manager is not available in the browser.
Create a skill with the agent
Type /create-skill in the composer and describe the workflow you want to
reuse. Specify whether it belongs to an attached project or your personal
skills. The agent helps write or update the SKILL.md and checks its format.
Personal skills are stored on your computer, so browser turns cannot use them.
Where skills live
- Project skills live in the repository under
.agents/skills/. Commit them to make them available to new checkouts and everyone working in the project. - Personal skills live under
~/.agents/skills/and follow you across projects on that machine.
The common layout is .agents/skills/<name>/SKILL.md. You can also group
skills into nested category folders, such as
.agents/skills/releases/<name>/SKILL.md. The folder containing SKILL.md
is the skill folder.
For skills used only in Delta, use .delta/skills/. See
Delta-specific overrides.
This is still a project folder, not a private location outside the repository.
Choose where to keep a merge skill
| If the landing workflow is… | Put the skill in… | What to expect |
|---|---|---|
| Shared with your team | .agents/skills/<name>/SKILL.md | Commit it so new checkouts and teammates receive it. |
| Specific to Delta but shared with the project | .delta/skills/<name>/SKILL.md | Commit it for new checkouts. This avoids changing other agents’ instructions; it does not make the skill private. |
| Personal across projects on this computer | ~/.agents/skills/<name>/SKILL.md | It is not scoped to one project or available to browser turns. |
Create Merge Skill opens a setup conversation using the parent’s live worktrees. The approved skill is available in the original thread immediately; you do not need to merge it back from setup. Commit project skills so new isolated threads and teammates receive them. A new top-level isolated thread starts from your configured branch, not the setup conversation’s uncommitted files. See Where new threads start and Merge changes.
There is no documented project-scoped, Git-ignored skill location that Delta
automatically copies into every new isolated thread. Ignored files are not
recorded or synced, and .delta/skills/ does not change that. Do not rely on
an uncommitted or ignored skill to appear in a new thread.
Delta also ships built-in skills. /change-guide creates a structured
walkthrough of an existing code change, and the agent can search your other
threads for relevant context on its own. To ask about Delta itself, mention
@Delta in any message; see
Getting Started. When a project
skill and a personal skill share a name, the project skill wins.
Anatomy of a skill
A skill is a folder containing a SKILL.md that opens with YAML
frontmatter, followed by the instructions:
---
name: release-checklist
description: Cut and verify a release. Use when asked to prepare a release.
---
Steps for the agent to follow...
name uses lowercase letters, numbers, and hyphens. The agent reads the
description to decide whether the skill applies, so write it the way you’d
tell a colleague when to reach for the workflow.
Two optional frontmatter fields control how a skill is invoked:
user-invocable(defaulttrue): whether the skill appears in the composer’s/menu.disable-model-invocation(defaultfalse): whentrue, the agent never loads the skill on its own; it runs only when you invoke it.
A skill folder can also carry supporting files, such as scripts or templates, and the instructions can point to them.
Invoke a skill directly
Type / in the composer to pick a skill by name. The same menu also lists
built-in commands such as /compact, /change-model, /set-thinking-level,
/toggle-fast, /add-project, /fork, and /review. Typing or pasting a
full skill command such as /release-checklist attaches that skill when you
confirm it or type a space after the name; until then the picker stays open
so you can check the match.
When there’s room, the selected skill’s description appears beside the picker.
With Send With Modifier enabled,
press Cmd+Enter on macOS or Ctrl+Enter on Linux and Windows to accept the
highlighted skill and send your message. Press Enter to insert the skill
without sending.
The agent runs the attached instructions without waiting for a matching request. This works well for workflows such as “cut a release” or “review this PR,” where you want to choose exactly when the skill runs.
If you invoke a skill that can’t load, Delta stops before sending and shows the file path and reason. Fix the skill file, then send the same draft again. An unrelated invalid skill does not block sending. When discovering merge skills, Delta skips skills that fail to load and includes their diagnostics in the child agent’s instructions. If none can load, setup offers to help create a working skill. A discovery failure offers a retry in the Merge menu.
Configure a merge skill
To make a skill eligible for
Merge, add
metadata.delta-action: land to its frontmatter. For example, an existing
landing skill can start with:
---
name: land
description: >-
Land this project's changes only when explicitly requested.
Do not use for review, preparation, or skill installation.
metadata:
delta-action: land
---
Keep your project’s landing instructions below the frontmatter. The metadata
value must be lowercase land, even though the interface calls the action
Merge. Existing skills named land remain valid; naming the skill or its
folder land is not enough.
Delta discovers eligible skills before creating a Merge subthread. With one
eligible skill, Merge Changes starts a child that runs it. With several,
choose a skill from Merge Skills in the menu before the child starts.
Skills with user-invocable: false are hidden from the menu. To make a skill
selectable, omit that field or set it to true.
Invoking a skill with /land directly runs it in the current conversation;
the metadata alone does not create a subthread.
If you don’t have a merge workflow yet, choose Create Merge Skill to set one up. Approving setup creates or updates the skill, but does not merge or publish any changes.
When to write one
Write a skill when you find yourself giving an agent the same instructions twice for a particular kind of task. Common examples:
- A code review checklist tuned to your codebase.
- A release or deployment procedure.
- Style and voice rules for public-facing writing.
For standing rules that should apply whenever the agent works in a repository
or one of its folders, use an AGENTS.md file instead. See
Settings.