> ## Documentation Index
> Fetch the complete documentation index at: https://dify-6c0370d8-yajing-skill-management-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage the Skill Library

> Create, edit, publish, and share library skills for your agents

## Create a Skill

From **Skills**, click **Create**. To start from an existing skill instead, choose **Duplicate** from its **⋯** menu; the copy starts as a draft.

<Info>
  Creating and managing skills requires the Editor role or above.
</Info>

Write the skill by hand, or draft it with the **Skill Builder**: describe the scenario or attach an existing process doc, and it suggests content in the chat; applying it is up to you.

Either way, the skill takes shape in `SKILL.md`: the frontmatter carries its `name`, `description`, and other metadata, and the body holds the procedure itself.

```markdown theme={null}
---
name: refund-requests
description: Handle customer refund requests the standard way. Use when a customer asks for a refund or reports a billing issue.
metadata:
  display-name: Refund requests
---

Check the order status before promising anything.
Offer a refund only within the 30-day window.
Keep the tone warm, and close with a help-center link.
```

The following settings shape how the skill is found and used:

* **Names**: after a skill is published, renaming it changes only the `display-name`.
* **Description**: state what the skill does and when an agent should use it.
* **Metadata**: to keep extra information with the skill, add custom frontmatter fields.
* **Supporting files**: if the task needs more than instructions, add templates, scripts, or reference docs through the file tree.
* **Tags**: add them from the editor sidebar, then filter by tag on the **Skills** page. They're for organizing the library only. Changes to tags take effect without publishing.

When the skill is ready, publish it to make it available to agents.

## Publish and Versions

Your edits autosave as a draft and reach agents only when you publish. Each publish is saved as a version you can revisit or restore later.

<Note>
  Restoring a version publishes it immediately as the newest version.
</Note>

## Add to Agents

From **Agents**, open the agent's **Configure** page. Under **SKILLS**, click **Add** and choose **From skill library**. The agent follows the skill's latest published version from then on, and decides when to use it by its name and description. To point the agent at the skill for a specific step, reference it in the prompt with `/`. You can also add skills in a workflow's [Agent node](/en/self-host/use-dify/nodes/agent).

## Import a Skill

To bring in a skill built elsewhere, click **Import** on the **Skills** page and choose a `.zip` or `.skill` package in the [Agent Skills](https://agentskills.io/home) format. The package arrives as a draft for you to review and publish.

To turn an agent's embedded skill into a library skill, import its package here.

## Export a Skill

To take a skill beyond this workspace, choose **Export** from the **⋯** menu on its card in **Skills**. You get the skill's latest published version as a `.zip` package in the Agent Skills format.

## Delete a Skill

Deleting a skill removes it from the workspace and from every agent that uses it, along with all of its versions. A deleted skill can't be recovered; export a copy first if you may need it again.