---
title: Manage skills
slug: agent-platform/docs/manage-skills
createdAt: 2026-08-12T15:37:05.000Z
---

Skills give Mark (Optimizely Agent Platform) additional context about how to behave and when to run. Mark evaluates all available skills and determines which ones apply to the current task. Mark can apply multiple skills to a single action, assessing all applicable skills to produce output that matches your prompt.

## Access skills

To access skills in Mark, complete the following steps:

1. Log in to [Optimizely](https://home.optimizely.com/).
2. Select your organization.
3. Click **Mark**.

![Screenshot of the Optimizely World Organization page where Mark is one of the quick link tiles](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/IJp9Lul9HZT1dGYaFbve4_mark-card-on-welcome-back-page0.png)

4. Go to **Context > Skills**.

![Screenshot of Context where the Skills tab displays](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Zd4aT5Nl9Wd9sCaCiVSTc_mark-chat-reusables-context-skills0.png)

:::Heading{depth="1" indent="2"}

:::

## Create skills

See [Create an organization-wide skill](docId\:N3n_NnF8J0Ykujmp2Sg00)  or [Create a personal skill](docId\:us7iZ6Rvo_03yXtLw_vdr).

## Import and export skills

To back up a skill or move it to another organization, see [Import and export skills](docId\:fz5lUg7NrQV5klh9G9I57).

## Modify skills

Complete the steps in the [Access skills](docId\:nsSgCk7YZ5kHj0x6ma75P) section to open the **Skills** tab. Then open the skill you want to edit using one of the following methods:

- Click the skill name.
- Click **More (...) > Edit**.

![Screenshot of the Skills list where the More menu of a skill row is open and Edit is an option](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/GrT0BhAiuD05WR-FTTwae_mark-chat-reusables-edit-skill0.png)

When updating a skill, modify any of the following fields:

- **Name** – A short, descriptive label that identifies the skill.
- **Active** – Whether the skill is on or off.
- **Shortcut** – A keyword you can use to call this skill from [Mark chat](docId\:dtNBEttEGVvkhNkwNypLM) by entering /.
- **Who is this skill for?** – Whether the skill is an organization skill or a personal skill. See [Switch a skill between personal and organization](docId\:nsSgCk7YZ5kHj0x6ma75P).
- **Core Skill** – The behavioral prompt Mark uses to generate content.
- **When to use** – Specifies whether this skill triggers by keyword and intent matching or when specific tools are used.
- **Where to use** – The Optimizely product and instance where Mark should use the skill.

Teammates with the **Add and edit organization skills** permission receive a notification when you modify an organization skill. You do not receive a notification for skills you update. See [Notifications overview](docId\:BA9tH-MbtxzBbY-iz2rRX).

### Best practices for modifying skills

When modifying skills, adhere to the following best practices:

- **Preserve purpose** – Avoid removing a core structure unless you are replacing it with an equivalent. For example, if the skill uses a table or list format to define platform-specific rules, keep that structure.
- **Be explicit and actionable** – Use clear, imperative language. Tell Mark what to do, not just what to consider.
- **Keep platform logic intact** – Maintain conditional logic if the skill is platform-specific (such as Instagram or LinkedIn). Remove it only if your content use case is limited to a single channel.
- **Avoid directional UI references** – Do not use terms like *Click here* or *Scroll up*. Instead, use context-aware phrasing like *Select a post type*.

### Switch a skill between personal and organization

[Mark administrators](docId\:pe0pbUJveWrG8ewvZWDRE) can change a skill type without rebuilding the skill. For example, promote a personal skill that performs well to an organization skill so your whole team uses it.

To switch a skill type, complete the steps in the [Modify skills](docId\:nsSgCk7YZ5kHj0x6ma75P) section to open the skill. Then select **Personal** or **Organization** for **Who is this skill for?**

If the shortcut handle is already in use, Mark appends `-personal` or `-org` to prevent a conflict.

Only administrators can change a skill type.

### Use Mark to help modify skills

If you need help with your updates, ask Mark to make them for you. While on the edit skills page, complete the following steps:

1. Click **Ask Mark**.
2. Enter a prompt requesting your changes. For example, enter *Help me update this skill so that its **when to use** specifies it should be used whenever creating PowerPoint presentations.* Opal uses the [skills builder](docId\:znGZnWOsmHU01HuRjIPEo) to generate an action card with your updates.
3. Review the changes and update any fields.
4. Click **Update** to make the updates.

![Screenshot of a skill being edited where Update saves the changes](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/9th8fHS8ZgwddEvmj1QKB_update-skill-with-opal.png)

## Delete skills

Delete skills from two locations in Mark, as described in the following sections.

Teammates with the **Add and edit organization skills** permission receive a notification when you delete an organization skill. You do not receive a notification for skills you delete. See [Notifications overview](docId\:BA9tH-MbtxzBbY-iz2rRX).

### Delete from the Skills page

To delete a skill from the **Skills** page, complete the steps in the [Access skills](docId\:nsSgCk7YZ5kHj0x6ma75P) section, then complete the following:

1. Find the skill you want to delete.
2. Click **More (...) > Delete**. 

   ![Screenshot of the Skills list where the More menu of a skill row is open and Delete is the last option](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/LhLFxQkzRCfEOZ5Vph7uO_mark-chat-reusables-delete-skill0.png)
3. Click **Delete** on the confirmation page.

### Delete from the skills details page

To delete a skill from the **Edit Skills** page, complete the steps in the [Access skills](docId\:nsSgCk7YZ5kHj0x6ma75P) and [Modify skills](docId\:nsSgCk7YZ5kHj0x6ma75P) sections. Then, click **More (...) > Delete Skill**.

![Screenshot of a skill where the More menu is open and Delete skill is an option](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/kN0ANleCsow23djCTt00z_mark-chat-reusables-delete-skill-from-skill-details0.png)

Click **Delete** on the confirmation page.

### Delete multiple skills

Delete several skills in one action to keep your skills list organized.

1. Select the checkbox for each skill you want to delete.
2. Click **Delete**. 

   ![Screenshot of the Skills list where Delete shows the number of selected skills](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/bQMSoo0G6U9L1nhqSVqCO_mark-chat-reusables-delete-multiple-skills0.png)
3. Click **Delete** on the confirmation page.

To select every skill on the page, select the checkbox in the table header. **Delete** shows the number of skills you selected.

:::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).
:::