Brand Voice Guidelines skill
The Brand Voice Guidelines skill is an organization skill from the Skills Directory in Mark (Optimizely Agent Platform). It enforces your brand's tone, style, and grammar rules across all content your team produces. Mark rewrites anything that does not meet the standard.
The skill applies to everyone in your organization when you choose Organization during configuration. Creating an organization skill requires the Manage Skills permission.
Skill details
The following details apply to this skill:
- Shortcut – /brand-voice-guidelines
- Type – Organization skill
What the skill does
The skill does the following:
- Checks written content against one set of voice rules and rewrites anything that does not meet them.
- Applies your voice pillars, a default tone standard, and a ban list with preferred swaps. Voice pillars are the core traits that define your brand's tone. Also applies writing mechanics such as the Oxford comma, contractions, numerals, and sentence case.
- Calibrates tone by channel, such as website, product UI, docs, email, social, and ads.
- Avoids generic copy and repeated sentence structure, and offers three to five differentiated headline angles.
Before you begin
Confirm the following before you install the skill:
- You must have the Manage Skills permission to install this skill. If you do not, click Request in the Skills Directory to ask an administrator to install it.
- Have your answers and files ready. Mark asks for them during configuration.
Information Mark asks for
Mark asks for the following during configuration. Skip optional items if you do not need them.
- Brand Name – The brand this skill applies to.
- Brand and Audience – A short description of your brand and who it talks to.
- Voice Pillars – Your core voice pillars, one per line. Give each pillar a "do" and a "do not", such as "Direct: lead with the point. Do not bury it in a preamble."
- (Optional) Brand Material – A style guide, samples of shipped copy, or both. Uploaded material overrides what you type, and shipped samples override the guide where they disagree.
- (Optional) Brand-Specific Bans and Swaps – Words to ban outright, and words to swap for preferred alternatives. If you skip this, only the default ban list applies.
- (Optional) Reference Lines – Example lines that show the energy and angle you want. Mark matches the style, not the wording.
Install the skill
Go to Directory > Skills, find Brand Voice Guidelines, and click Install. In the Setup required dialog, click Set up in chat. Mark asks who the skill is for, Myself (Personal) or Organization. Mark then asks whether to answer the remaining questions in chat or upload a document. For the full procedure, see Install a skill that needs configuration.
Use the skill
After configuration, enter /brand-voice-guidelines in Mark chat to run the skill on demand. Mark also applies it automatically when your request matches its When to use conditions. Try prompts like the following:
- Write a homepage hero headline for our new feature.
- Rewrite this email so it matches our brand voice.
- Give me five headline angles for this ad.
Things to know
Because this is an organization skill, one person's answers set the brand voice for everyone in your organization. Mark has no draft or approval step, so review your answers before you confirm them.
Update the skill
When Optimizely publishes an updated version, Update displays on the skill's card in the Skills Directory. Mark keeps the information you provided during configuration and asks only for anything the updated version adds. To correct answers that are no longer accurate, edit the installed skill. See Update a skill and Manage skills.
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.