---
title: Create an organization-wide skill
slug: agent-platform/docs/create-an-organization-wide-skill
createdAt: 2026-08-12T15:37:10.000Z
---

Organization skills apply to everyone who uses Mark (Optimizely Agent Platform) in your organization. Organization skills let [Mark administrators](docId\:pe0pbUJveWrG8ewvZWDRE) define consistent, reusable guidance that shapes how Mark responds across your organization. When you create a [skill](docId:1HTjxW2J-ZOkYEZMwnasU), you define the objective, the steps Mark follows, the response format, and the conditions that activate it.

## 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 an organization-wide skill

To add a skill for the entire organization, complete one of the following options:

### From Mark chat

Create a skill from [Mark chat](docId\:dtNBEttEGVvkhNkwNypLM) 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](docId\:SXjD3qqg-0gS2g4KajfyO).

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)

### From the skills tab

Complete the steps in the [Access skills](docId\:N3n_NnF8J0Ykujmp2Sg00) section and then complete the following:

1. Click **Add skill**. 
2. Select **Organization Skills**. 

   ![Screenshot of the Skills tab in Context where Create new skill starts a skill](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/oFeVLaJLhZC2CPoyL5qWC_mark-chat-reusables-create-new-skill0.png)
3. Enter a **Name** for your skill.
4. (Optional) Toggle **Active** on or off.
   - Toggle **Active** on to let Mark use your skill.
   - Toggle **Active** off to prevent Mark from using your skill. Use this setting while developing the skill.
5. (Optional) Enter a **Shortcut.** The shortcut is what you use to call the skill. Skills without a shortcut do not display in the / menu in Mark chat or in the **Choose skills** picker when creating a specialized agent.
6. Keep **Organization** selected for **Who is this for?**
7. Select an option for **When to use**.
   - **Keywords or phrases** – Enter your intent, keywords, or phrases that trigger this skill when used.
   - **Tools** – Click **Add tool** and select the tools that apply this skill automatically when they run.
8. Enter a **Core Skill**, which is information and context Mark uses to tailor its output. Include details such as guidelines, response formats, and constraints. Double-click text to add styling. See [Core skill](docId:1HTjxW2J-ZOkYEZMwnasU).
9. (Optional) Click **Add File** to upload files Mark can use when using this skill.
10. (Optional) Click **Add Product** in the **Where to use** section. If you do not add products, the skill is available for all products.
    1. Select an Optimizely product from the **Select Product** drop-down list.
    2. Select an instance from the **Select Instance** drop-down list.
    3. Click **+** to add another product and instance.
    4. Click **Delete** to remove the product and instance.
11. (Optional) Click **Add Tool** and select tools that must always be available for this skill.
12. Click **Save** to create your skill.

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

Mark Administrators can change a skill between organization and personal using the **Who is this for?** radio buttons. See [Manage skills](docId\:nsSgCk7YZ5kHj0x6ma75P).

### From an existing skill

To import a skill instead of building one, see [Import and export skills](docId\:fz5lUg7NrQV5klh9G9I57).

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