---
title: Create or edit a skill with the skills builder
slug: agent-platform/docs/create-or-edit-a-skill-with-the-skills-builder
docTags: 
createdAt: 2026-08-12T15:37:09.000Z
---

The skills builder is a design-time AI assistant in Agent Platform. Use it to create reliable skills automatically in [Mark chat](docId\:dtNBEttEGVvkhNkwNypLM). The skills builder helps you build a [skill](docId:1HTjxW2J-ZOkYEZMwnasU). A skill shapes how Mark behaves in a given task.

## When to use the skills builder

Use the skills builder when you create or update an organization or personal skill. The skills builder works best at design time, before a skill becomes active, to prevent the most common reliability issues:

- Vague or incomplete skills.
- Missing tool dependencies.
- Incorrect **When to use** conditions.

## Use the skills builder

Create a skill from [Mark chat](../../use-opal/opal-chat/access-and-explore-opal-chat.mdx) using the **Create Skill** action card Mark generates with the skill details. Review and edit the fields on the action card, then click **Save** to create your skill without leaving the conversation.

The `create_or_edit_skill` tool must be **Active** and **Enabled in Chat** to use the skill builder.

To configure these settings, see [Manage tools](../../tools/manage-tools.mdx).

To generate an action card to create a skill, you can prompt Mark to do so or click **Create skills**.

Example prompts:

- *Help me create a skill.*
- *Save this as a skill.*
- *I want to create a skill.*

![Screenshot of the Create skills form where you enter the details of a skill](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/I8dxsb2PqXgsCX3-jAxWn_mark-chat-reusables-create-skill0.png)

## Related articles

- [Skills overview](docId:1HTjxW2J-ZOkYEZMwnasU) – Understand how skills shape Mark's behavior.
- [Use Mark to create or edit a specialized agent automatically](docId\:jRodvjyE-5jiJfwac6Qai) – Similar design-time assistance for building agents.

:::hint{type="info"}
**Note**

If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See [Turn generative AI off across Optimizely applications](docId\:X5U0kKD2azV5cIdNqwGNj).
:::