---
title: Add a skill
description: Give your AI agents a skill, a named set of instructions for one job, written from scratch or started from a preset, and enable or disable it from the Skills table.
sidebar:
  order: 2
area: ai
feature: agents
appPath: /ai/agents/skills
lastVerified: 2026-10-29
version: "2026-10-27"
audience: admin
screenshots:
  - id: ai-agents-add-skill
    caption: Add skill asks for a name, a description and the instructions.
related:
  - ai/agents
  - ai/mcp-servers/add-an-mcp-server
  - ai
---

A skill is what an AI agent follows for one job: a name, a description that says what the skill does and when to use it, and instructions in markdown that say how. You add it under **AI**, **Agents**, **Skills**, blank or from a preset, and change its description and instructions in place afterwards.

## Before you start

- You are an admin or owner. Only those roles see **AI** in the navigation.
- Pick a name that will not change: lowercase letters, numbers and hyphens, starting with a letter, up to 63 characters. A skill and an MCP server cannot share a name.
- Have the instructions ready, in markdown, or choose the preset that comes closest.

![Add skill asks for a name, a description and the instructions.](https://support.pyn.ai/media/ai/agents/ai-agents-add-skill.png)

## Steps

1. In Pyn, open **AI** in the left navigation, then **Skills** under **Agents**.

2. Select **Add**. The **Add skill** page opens. To begin from a ready-made skill instead, open the arrow beside **Add** and select **Add from Preset**: pick a category on the left, then a preset. Choosing one fills in the name, description and instructions, all of which you can still change, and nothing ties the skill to the preset afterwards.

3. Enter the **Name** (for example `leave-policy-faq`). The field explains "Lowercase letters, numbers and hyphens. It cannot be changed later."

4. Enter the **Description**: "What the skill does, and when an agent should use it."

5. Enter the **Instructions**: "The body of the SKILL.md, in markdown."

6. Select **Add**. The skill's panel opens on the right.

> **Note:** If saving fails the page shows "The skill could not be added. Its name may already be in use." An archived skill frees its name.

## What you should see

The skill's row in the **Skills** table shows its name, its description and **Enabled**. In the panel, the description sits at the top and the instructions under **Instructions**; edit either in place. To keep a skill without agents using it, select **Disable** in the row's **...** menu; its status reads **Disabled** until you select **Enable**. **Archive** removes it from the table and frees its name.

## Related

- [Agents](https://support.pyn.ai/ai/agents/) for the Skills table and the other views under Agents.
- [Add an MCP server](https://support.pyn.ai/ai/mcp-servers/add-an-mcp-server/) to give an AI client operations to call.
- [AI](https://support.pyn.ai/ai/) for who sees the area.
