Website Best Practices skill
The Website Best Practices skill is an organization skill from the Skills Directory in Mark (Optimizely Agent Platform). It defines your ideal landing page formats, structure, and design principles. Teams can then build pages consistently and efficiently.
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 – /website-best-practices
- Type – Organization skill
What the skill does
The skill does the following:
- Plans, builds, clones, and reviews pages from an 11-type pattern library, a set of proven page layouts.
- Builds only from the components you list or that Mark discovers in your Content Management System (CMS). It validates values before writing.
- Applies section rules, accessibility thresholds, and Core Web Vitals targets. Core Web Vitals are Google's measures of page speed and stability.
- Ranks review findings. It sorts them into changes it makes automatically, changes that need your confirmation, and changes to test.
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.
- Connect a CMS in Mark to build pages, apply fixes, or create variants. Without one, Mark produces blueprints, review findings, and test plans that you apply by hand.
- Connect an analytics or experimentation tool for funnel diagnosis. Without one, reviews are heuristic.
- 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.
- Your Site, Audience, and Conversions – Your site, audience, and the conversions that matter.
- Page Building Blocks – The only components Mark can use, one per line.
- (Optional) Best Pages to Copy From – Live pages whose spacing and responsive behavior Mark copies, one per line.
- (Optional) Page Standards, Design System, or Messaging Document – A file. Including a messaging framework turns on the messaging-layer rules.
- (Optional) House Rules and Page Types – One per line.
Install the skill
Go to Directory > Skills, find Website Best Practices, 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 /website-best-practices 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:
- Plan a gated asset landing page for our benchmark report.
- Review this demo page and tell me what to fix first.
- Clone our best campaign landing page for the new webinar.
Things to know
Keep the following in mind:
- Mark saves pages as drafts unless your house rules allow publishing and you ask for it.
- The building blocks list is typed by hand, so update it when your CMS components change.
- The skill covers structure and messaging, not voice.
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.