Skills Directory overview
Add ready-made skills that Optimizely publishes from the Skills section of the Directory in Mark (Optimizely Agent Platform). A skill teaches Mark how you and your organization work. Examples include your brand voice, your report formats, and the keywords you target. Mark applies installed skills when they are relevant. Run a skill on demand with its shortcut, a command that starts with /, such as /accessibility-guidelines.
Most skills need information from you before they are useful. For example, the Brand Voice Guidelines skill needs your tone and style rules. When you install one of these skills, Mark asks for that information in a chat. Mark then creates the skill for you.
The Directory also includes the Virtual Teammates and Agents sections. For an overview of the three sections, see Directory overview.
For background on skills, see Skills overview.
Skill types
Each skill in the Skills section is one of the following types:
- Organization skill – Applies to everyone in your organization. Use these to enforce shared standards, such as brand voice or accessibility guidelines. An administrator or a user with the Manage Skills permission installs and configures an organization skill. Other users can request it.
- Personal skill – Applies only to you. Use these to capture how you work, such as your Objectives and Key Results (OKRs) or your report template. Any Mark user can install a personal skill.
Each skill card displays the skill type, Organization or Personal.
Prerequisites
Confirm the following before you install a skill:
- You have the Manage Skills permission if you install an organization skill. Without it, request the skill instead.
- Your organization uses at least one of the products that the skill requires. Otherwise, Install is unavailable, and its tooltip names the product you need.
Access the Skills section
- Log in to Optimizely.
- Select your organization.
- Select your Mark instance.
- Click Directory > Skills.
The Skills section displays skill cards, a search bar, and filters.

Available skills
Optimizely publishes skills for areas such as brand voice and messaging, report formatting, and planning. For the full list with each skill's shortcut, type, and description, see Skills in the Skills Directory.
Find a skill
Narrow the list of skills with the following search and filter options:
- Search bar – Enter a name or a word from a description to find a specific skill.
- Filter by – Select Installed or Not installed to display only those skills. Select All to display every skill.
- Tags – Select a tag to display only the skills with that tag.
- Type – Select Personal or Organization to display only that type of skill. Select All to display every skill.
- Sort by – Sort the skills by Newest, Oldest, Name A-Z, or Name Z-A.
Click Clear all to remove the filters you applied.
Compare skills
Each skill card displays the skill's name, a short description, its tags, its type, and any Optimizely products it requires.
Click a skill card to open its details page. The details page includes the following information:
- Overview – What the skill does.
- When to use – When Mark applies the skill.
- Tags – The skill's categories.
- Type – Whether the skill is an organization skill or a personal skill.
- Runs with – The tools that trigger the skill automatically. This field displays only for skills that Mark applies when it uses specific tools.
- Products – The Optimizely products your organization needs to install the skill.
- Files – Files that ship with the skill, such as templates.
- Auto-update – A toggle that displays after you install the skill.
- View Documentation – A link to documentation for the skill.
Install or request a skill
Install a skill to make it available in Mark. Some skills include placeholders, such as your brand name or a report template, so they need your input first. Mark collects it in a chat.
The label on a skill card depends on the skill's status and your permissions.
Label | When it displays | What it does |
|---|---|---|
Install | The skill is not installed, and you have permission to install it. | Installs the skill. If the skill needs configuration, Mark first collects your input in a chat. |
Request | The skill is an organization skill, and you do not have the Manage Skills permission. | Notifies the administrators in your organization who can install the skill. |
Installed | The skill is installed. | Click Installed skill actions to select Run, Manage (or View), or Uninstall. |
Update | An updated version of an installed skill is available. | Installs the updated version. See the Update a skill section. |
Install a skill that needs configuration
If a skill includes placeholders, installing it includes a configuration step. Complete it by answering the questions Mark asks in a chat. You do not fill in a form.
- Click Install on the skill in the Skills section.
- Click Set up in chat in the Setup required dialog.

Mark opens a chat and starts configuring that skill.
- (Conditional) Select Myself (Personal) or Organization if Mark asks who the skill is for. Mark asks only when you install an organization skill and have the Manage Skills permission.
- Select Answer here in chat or Upload a document when Mark asks how to fill in the remaining details.
- Answer here in chat – Mark asks its questions in small groups. When an input is a file, such as a PowerPoint template, Mark asks you to upload it.
- Upload a document – Upload a document that contains your answers. Mark fills in what it can and asks in chat for anything missing. Mark accepts PDF, Word, PowerPoint, Excel, JSON, text, image, audio, and video files.
- Review the Create Skill draft that Mark displays. Edit any of the following:
- Name – The skill name. A toggle next to it sets whether the skill is active.
- Shortcut – The command that runs the skill.
- Who is this for? – Personal or Organization. Users with the Manage Skills permission can switch the scope here.
- Activation Trigger – When Mark applies the skill, such as Keyword / Intent.
- Core Skill – The instructions Mark follows.
- Click Set up.
When configuration is complete, Mark creates the skill, and the skill displays as installed in the Skills section. Mark installs nothing until you finish the configuration conversation.
Users without the Manage Skills permission can still configure a personal skill for themselves. Mark skips the question about who the skill is for and creates the skill as a personal skill.
Install a skill that does not need configuration
If a skill does not need configuration, click Install. Mark adds the skill immediately.
Resolve a shortcut conflict
If another skill in your organization already uses the skill's shortcut, Mark displays That skill shortcut is taken. Enter a different shortcut in New skill shortcut and click Install to continue.
Connect required tools
If the skill uses tools that are not connected, Mark prompts you to connect them before it installs the skill. Connect the tools, or continue without them. A skill does not work until its tools are connected.
Request an organization skill
If you do not have the Manage Skills permission, an organization skill displays Request instead of Install.
- Click Request. Mark notifies the administrators in your organization who can install the skill.
- Wait for an administrator to install the skill.
After you send a request, Request changes to Requested and stays disabled for 12 hours.
Use an installed skill
Use an installed skill in the following ways:
- Run from the Skills section – Click Installed skill actions on the skill card and select Run. Alternatively, click Run on the skill's details page. Mark opens a chat with the skill applied.
- Use the shortcut – In Mark chat, enter / and select the skill, or enter the skill's shortcut. See Shortcut.
- Let Mark apply it – Mark applies a skill automatically when your request matches the skill's When to use conditions. Mark also applies a skill when it uses one of the skill's Runs with tools.
Manage the skills you installed
An installed skill becomes one of your organization's skills or one of your personal skills. To edit it, do one of the following:
- Click Installed skill actions on the skill card and select Manage.
- Click Manage on the skill's details page.
If you do not have permission to edit an organization skill, the option is View. See Manage skills.
Update a skill
When Optimizely publishes an updated version of a skill you installed, the skill card displays Update.
- Click Update.
- Click Update in the Update dialog.
Warning
Updating overwrites the skill with the updated version, including any changes you made to your installed copy. You cannot undo an update.
If you configured the skill in a chat, Mark keeps the information you provided earlier. It asks only for information that the updated version adds, which is often nothing.
Auto-update
For skills that did not need configuration, have Mark install updated versions automatically. Open the skill's details page and turn on Auto-update. For organization skills, only users with the Manage Skills permission see this setting.
Skills you configured in a chat do not update automatically. An automatic update would overwrite the information you provided. Click Update when an updated version is available.
Uninstall a skill
Uninstall a skill to remove it from your installed skills. To uninstall an organization skill, you must have the Manage Skills permission.
Warning
Uninstalling an organization skill removes it for everyone in your organization.
- Click Installed skill actions on the skill card.
- Select Uninstall.
- Click Uninstall in the Uninstall this skill? dialog.
Mark removes the skill from your installed skills. Reinstall it from the Skills section at any time.
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.