---
title: Website Best Practices skill
slug: agent-platform/docs/website-best-practices-skill
createdAt: 2026-10-06T00:00:00.000Z
---

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](https://docs.optimizely.com/agent-platform/docs/skills-directory-overview#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](https://docs.optimizely.com/agent-platform/docs/skills-directory-overview#update-a-skill) and [Manage skills](https://docs.optimizely.com/agent-platform/docs/manage-skills).

:::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](https://docs.optimizely.com/opti-id/docs/generative-ai-settings).
:::
