Accessibility Guidelines skill
The Accessibility Guidelines skill is an organization skill from the Skills Directory in Mark (Optimizely Agent Platform). It sets your organization's web accessibility standards so every page meets inclusion targets. It also improves search engine optimization (SEO) and AI search visibility.
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 – /accessibility-guidelines
- Type – Organization skill
What the skill does
The skill does the following:
- Audits pages and content against the most frequently failed Web Content Accessibility Guidelines (WCAG) 2.2 A and AA criteria.
- Writes accessible alt text, headings, link text, form errors, and transcripts.
- Labels every finding as Verified, Likely, or Manual check needed. It also rates each finding Critical, High, Medium, or Low, with an effort size.
- Turns findings into a dated roadmap, and notes SEO and AI search benefits where they apply.
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.
- Mark uses a connected browser, web fetch tool, crawler, or accessibility scanner when one is available. Without one, paste HTML or upload a saved page.
- 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.
- Website and What This Covers – Your scope.
- Accessibility Target and Deadline – If your answer is vague, Mark applies WCAG 2.2 AA with a proposed 12-month deadline. Mark tells you which default it applied.
- (Optional) Existing Audit or Accessibility Statement – A prior audit or conformance report. If you skip this, the first audit becomes your baseline.
- (Optional) Brand Colors and Known Exceptions – If you skip this, Mark measures contrast from the page and proposes no new colors.
- (Optional) Anything Specific to Your Team – Owner routing, fix timelines, and reporting language.
Install the skill
Go to Directory > Skills, find Accessibility 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 /accessibility-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:
- Audit this page for accessibility.
- Write alt text for these images.
- Create an accessibility roadmap for the next 12 months.
Things to know
Keep the following in mind:
- Mark cannot run assistive technology or test with a real keyboard. Every report lists the manual checks to complete.
- Mark never declares legal compliance. Have legal review any public accessibility statement.
- Content that loads with JavaScript cannot be fully checked from page source, so those findings are capped at Likely.
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.