Web Copy Guidelines skill
The Web Copy Guidelines skill is an organization skill from the Skills Directory in Mark (Optimizely Agent Platform). It validates headlines, subheads, and calls to action (CTAs) for web page variations against your copy rules. The rules cover voice, grammar, claims, and cadence, which sets the word-count limits for each copy element. Mark rewrites or removes anything that conflicts.
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 – /web-copy-guidelines
- Type – Organization skill
What the skill does
The skill does the following:
- Validates headlines, subheads, and CTAs for web pages and A/B test variations against your voice, grammar, claims, and cadence rules.
- Rewrites or removes anything that conflicts. Mark drops claims that fail your rules instead of rewording them.
- Applies your color palette and CTA accent rules to proposed style changes, including contrast checks.
- Uses your uploaded guide first, then your typed answers, and uses the live page only for facts.
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 and Where This Applies – The brand name and the web pages these rules cover, such as the homepage, landing pages, or pricing page.
- Voice Traits – The traits your web copy should have.
- Style Guide and Protected Names – Grammar rules and names that must keep their exact capitalization.
- Color Palette and CTA Accent – Your palette, one color per line, and the accent color used for CTAs.
- (Optional) Brand or Voice Guide – A file that sets your voice.
- (Optional) Approved Shipped Copy – Copy that already passed review.
- (Optional) Banned Words and Habits – If you skip this, only the default buzzword and urgency list applies.
- (Optional) Typography and Signature Treatment – Protected type treatments. If you skip this, Mark keeps proposals copy-only.
- (Optional) Approved Claim Sources – Where claims can come from. If you skip this, the live page is the only accepted source.
- (Optional) Touchstone Lines – Your strongest example lines.
Install the skill
Go to Directory > Skills, find Web Copy 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 /web-copy-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 three headline variations for this landing page.
- Check this A/B test variation against our brand rules.
- Suggest a CTA for this hero section.
Things to know
Keep the following in mind:
- Default cadence limits apply unless your guide overrides them. Headlines have six words or fewer, subheads have 22 words or fewer, and verb-led CTAs have two to four words.
- Because this is an organization skill, one person's answers set the rules for everyone in your organization. Mark has no draft or approval step.
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.