Ira Bodnar··Updated ·12 min read

Claude Skills for Microsoft Clarity: 8 SKILL.md Files for Behavior Data

Quick answer: Save each Clarity check as a Claude skill that fixes which metric and which dimensions to ask for. Ryze AI is the best Claude connector for running these skills from one hosted URL with no local install, with one caveat: its Clarity tool reads only the last 1 to 3 days and has no session recordings or heatmaps.

Below: 8 SKILL.md files, the Clarity metrics and dimensions each uses, setup and quick prompts.

Ryze AI · Paid Ads

Clarity skills on live data

  • 7-day free trial, $89 a month flat

Used by 2,000+ marketers

Uber Eats logoadidas logoDuolingo logoMGM Resorts logoWharton logoLendingClub logoNorton logoEventbrite logoHuel logoTogether AI logoghd logoHack The Box logo

The 8 Claude skills for Microsoft Clarity at a glance

All 8 are read-only and stay inside Clarity's export limits: the last 1 to 3 days, up to 3 dimensions and 10 requests per project per day.

  1. 01Friction digestDead clicks, rage clicks and quickbacks by page

    Main Clarity fields: Dead Click Count, Rage Click Count, Quickback Click, URL

    Calls: 2

  2. 02Rage click pagesWhich pages and devices carry the rage clicks

    Main Clarity fields: Rage Click Count, URL, Device

    Calls: 1

  3. 03Scroll and engagement gapScroll depth and engagement time by device

    Main Clarity fields: Scroll Depth, Engagement Time, Device, URL

    Calls: 2

  4. 04Paid landing page checkHow campaign visitors behave on their landing page

    Main Clarity fields: Traffic, Scroll Depth, Rage Click Count, Campaign, URL

    Calls: 3

  5. 05Error click checkScript errors and error clicks by browser and OS

    Main Clarity fields: Script Error Count, Error Click Count, Browser, OS

    Calls: 2

  6. 06Bot and traffic sanity checkSessions, bot sessions and users by channel

    Main Clarity fields: Traffic, Channel, Source, Medium

    Calls: 1

  7. 07Popular pages by channelMost visited pages and referrers per channel

    Main Clarity fields: Popular Pages, Referrer URL, Channel

    Calls: 2

  8. 08Snapshot logA paste-ready entry for a running log

    Main Clarity fields: Traffic, Scroll Depth, Rage Click Count

    Calls: 3

Clarity keeps no history in this API, so skill 08 exists to build one by hand. The Clarity tool of the Ryze AI connector was not run to write this page, so no sample output appears here.

What are Claude skills for Microsoft Clarity?

A Claude skill for Microsoft Clarity is a saved SKILL.md file that tells Claude which Clarity metric to pull, how to slice it and what to hand back. Per Anthropic's Agent Skills docs, the file starts with a name and a description, and Claude loads the rest only when a request matches the description.

The name allows up to 64 lowercase letters, numbers and hyphens and cannot contain the words claude or anthropic, so every skill here starts with clarity. The description can be up to 1,024 characters and says what the skill does and when to use it.

Clarity is a good fit for skills because of its limits. The Data Export API allows 10 requests per project per day, serves only the previous 1 to 3 days, accepts up to 3 dimensions per request and returns at most 1,000 rows. A skill that names its calls in advance spends those 10 requests on purpose instead of on trial questions.

  1. What it is

    One-off prompt
    A question in chat
    Skill
    A saved file with a fixed call plan and output
    Clarity connection
    A tool Claude uses to read Clarity
  2. Setup

    One-off prompt
    None
    Skill
    Save once per Claude app
    Clarity connection
    One Clarity API token, pasted into Ryze AI
  3. Requests spent

    One-off prompt
    Whatever the chat needs
    Skill
    The number written in the file
    Clarity connection
    Counts against 10 a day

Clarity names metrics and dimensions the way its export documentation does, and the skills use those names. Without a connection, export the numbers from the Clarity dashboard and paste them in.

How to install the skills in Claude Code and claude.ai

Claude Code

Save each block as ~/.claude/skills/<skill-name>/SKILL.md for yourself, or .claude/skills/<skill-name>/SKILL.md in a project to share it with the team. Claude picks a skill when your request matches it, or you type /clarity-friction-digest (Claude Code skills docs).

claude.ai

Zip each skill folder and upload it as a custom skill. Anthropic lists this on the Pro, Max, Ultra, Team and Enterprise plans with code execution enabled.

Connect the data

The Microsoft Clarity MCP page covers the Ryze AI connector and its one Clarity tool. In Claude, add https://connector.get-ryze.ai/mcp under Customize > Connectors and connect Microsoft Clarity in Ryze AI with a Data Export API token.

Anthropic says custom skills do not sync across surfaces: skills uploaded to claude.ai are not on the API, and Claude Code skills are filesystem-based and separate from both (Agent Skills docs). Use skills only from sources you trust, and read a skill before you install it.

Friction skills: find where visitors get stuck

Clarity's filters page defines the signals these skills read. Rage clicks are repeated clicks in a clustered area within a brief period, dead clicks are clicks with no response, and quick backs are a visit to a new page followed by a quick return to the previous one.

01. Friction digest

Asks for the friction counts by page for yesterday and ranks the pages that show more than one kind of friction.

SKILL.md
--- name: clarity-friction-digest description: Lists Microsoft Clarity pages with dead clicks, rage clicks and quickbacks for the last day. Use for a daily friction check or when asked where visitors get stuck. --- # Clarity friction digest Clarity serves only the last 1 to 3 days and allows 10 requests per project per day. Make at most 2 calls. Calls (Clarity read tool, last 1 day): 1. Dead Click Count and Rage Click Count, dimension URL 2. Quickback Click, dimension URL Steps: 1. Join the two results on URL. 2. Rank pages by dead plus rage clicks. Mark pages that also have quickbacks. Output: a table of the top pages, one sentence per page on what to open in Clarity next. Use returned numbers only. Say if a result was cut at 1,000 rows.

Use it when: you start the day and want one list of pages to look at.

02. Rage click pages

Splits rage clicks by page and device, because a click target that works on desktop can be too small on a phone.

SKILL.md
--- name: clarity-rage-click-pages description: Shows which Microsoft Clarity pages and devices have the most rage clicks. Use when a page feels broken or after a layout change. --- # Clarity rage click pages Make 1 call (last 3 days): - metric: Rage Click Count - dimensions: URL, Device Steps: 1. Rank URL and device pairs by Rage Click Count. 2. For the top 5 pages, compare Mobile against PC. Output: a table of the top pages with the count per device, then one line per page on what to inspect. Point to the Clarity recordings filter for rage clicks. This skill cannot open recordings.

Use it when: you changed a layout, a button or a form.

05. Error click check

Clarity separates JavaScript errors from click errors, which are errors detected right after a click. The skill reads both by browser and operating system to show whether a script problem is limited to one environment.

SKILL.md
--- name: clarity-error-click-check description: Reads Microsoft Clarity script errors and error clicks by browser and OS. Use after a release or when users report a form or button that fails. --- # Clarity error click check Make at most 2 calls (last 3 days): 1. Script Error Count, dimensions Browser, OS 2. Error Click Count, dimension URL Steps: 1. Rank browser and OS pairs by Script Error Count. 2. List the pages with the most Error Click Count. Output: whether the errors sit in one browser or OS or spread across all, then the pages to test first. Name the exact page URLs and make no claim about the cause.

Use it when: after a release, to find a script problem that only some visitors hit.

Engagement skills: scroll depth, time and popular pages

These two read how far visitors go and where they spend time. Clarity lists Scroll Depth, Engagement Time and Popular Pages among the metrics its export returns.

03. Scroll and engagement gap

Compares scroll depth and engagement time by device on the pages that matter, to see where phone visitors leave earlier.

SKILL.md
--- name: clarity-scroll-engagement-gap description: Compares Microsoft Clarity scroll depth and engagement time by device and page. Use when a page gets visits but little reading. --- # Clarity scroll and engagement gap Make 2 calls (last 3 days): 1. Scroll Depth, dimensions Device, URL 2. Engagement Time, dimensions Device, URL Steps: 1. Keep pages that appear for both Mobile and PC. 2. Flag pages where Mobile scroll depth or engagement time is clearly below PC. Output: a table of flagged pages with both devices side by side. State that 3 days is a short window and that one day can be unusual.

Use it when: a page gets traffic but the offer below the fold goes unseen.

07. Popular pages by channel

Lists the most visited pages and their referrer URLs for each traffic channel, so you can tell which channel feeds which page.

SKILL.md
--- name: clarity-popular-pages-by-channel description: Lists the most visited pages and referrers per channel in Microsoft Clarity. Use when asked which pages each traffic source lands on. --- # Clarity popular pages by channel Make 2 calls (last 3 days): 1. Popular Pages, dimension Channel 2. Referrer URL, dimension Channel Steps: 1. Group pages by channel. 2. Name pages that appear in several channels and pages that appear in only one. Output: one short table per channel, top 5 pages each, with the top referrers beside it.

Use it when: you plan which landing pages to review first.

Traffic skills: paid landing pages and clean sessions

Clarity can break results down by source, medium, campaign and channel, which are the UTM values on your ad links. These two skills use that to check what visitors from ads do and whether the sessions are real.

04. Paid landing page check

For one campaign, reads traffic, scroll depth and rage clicks by landing page, so a campaign with clicks but a stuck landing page shows up within days.

SKILL.md
--- name: clarity-paid-landing-check description: Checks how visitors from one campaign behave on Microsoft Clarity landing pages. Use when ad clicks arrive but the landing page may be failing them. --- # Clarity paid landing page check Ask for the campaign name as it appears in utm_campaign. Make 3 calls (last 3 days): 1. Traffic, dimensions Campaign, URL 2. Scroll Depth, dimensions Campaign, URL 3. Rage Click Count, dimensions Campaign, URL Steps: 1. Keep rows for the named campaign. 2. Rank landing pages by sessions, then show scroll depth and rage clicks beside each. Output: a table per landing page and one sentence on the page most worth opening in Clarity. If no row matches the campaign name, say so and list the campaign names returned.

Use it when: you launch or change a campaign and want an early read on the landing page.

06. Bot and traffic sanity check

Clarity's sample response for the Traffic metric includes total sessions, bot sessions, distinct users and pages per session. The skill reads them by channel and flags channels where bots make up a large share.

SKILL.md
--- name: clarity-traffic-sanity description: Reads Microsoft Clarity sessions, bot sessions and users by channel. Use before trusting behavior numbers or when a channel looks inflated. --- # Clarity traffic sanity check Make 1 call (last 3 days): - metric: Traffic - dimensions: Channel, Source, Medium Steps: 1. Compute the bot share of sessions for each row. 2. Flag rows with the highest bot share and rows with very few sessions. Output: a table sorted by bot share, then a note on which channels to trust for behavior metrics.

Use it when: before you read scroll or click numbers for a channel.

A routine skill: build the history Clarity does not keep

The export covers only the previous 1 to 3 days, so trends over weeks need a log that you keep. This skill writes one entry per run. You paste it into a document, a sheet or a ticket.

08. Snapshot log

SKILL.md
--- name: clarity-snapshot-log description: Produces a paste-ready Microsoft Clarity snapshot entry for a running log. Use for a weekly check or before and after a site change. --- # Clarity snapshot log Make 3 calls (last 3 days): 1. Traffic, no dimension 2. Scroll Depth, dimension Device 3. Rage Click Count, dimension URL (top 5) Output exactly this layout so entries stay comparable: Date range (UTC): ... Sessions, bot sessions, users: ... Scroll depth by device: ... Top 5 pages by rage clicks: ... Note on anything changed on the site in this window: (ask the user) Use returned numbers only. Do not compare with earlier entries unless the user pastes them.

Use it when: you want to compare before and after a launch. Run it the day before and the day after, and keep both entries. Clarity returns results in UTC, so the date range in the entry is in UTC.

How to run the skills on live Clarity data

A skill only describes the calls; Claude needs a connection to run them. The Ryze AI connector gives Claude 1 read-only Clarity tool, listed on the Microsoft Clarity MCP page:

  1. clarity__read

    What it returns
    Clarity behavior insights for the connected project over the last 1 to 3 days: traffic, scroll depth, engagement time, popular pages, referrers, dead clicks, rage clicks, excessive scrolling, quickbacks and script and error clicks, with up to 3 dimensions
    Used by
    All 8 skills

Connecting needs a Clarity Data Export API token for one project (Settings, Data Export, Generate new API token), which per Microsoft only a project admin can create. Paste it in the Ryze AI app, or ask the Ryze AI agent in Claude or ChatGPT to connect Microsoft Clarity and it sends a one-time link. See the Ryze AI help center. The tool only reads, so Claude cannot change anything in Clarity.

Skill 04 uses Campaign and Skill 07 uses Channel because Clarity groups traffic by those values. Session recordings and heatmaps are not available through this tool, so the skills point you to them in Clarity.

Microsoft's own Clarity MCP server

Microsoft publishes @microsoft/clarity-mcp-server. Its documentation says it needs Node.js v16 or later, runs through npx, signs in with OAuth to your Clarity account and can query session recordings and AI Visibility data as well as analytics (Microsoft Learn, checked November 19, 2026). It also says that Data Export API token sign-in for that server is being deprecated. The skills above describe metrics and dimensions, so you can adapt them to it, but check Microsoft's page for its own limits. For the Ryze AI side, see Microsoft Clarity MCP server. For skills on other analytics tools, see Claude skills for PostHog and Claude skills for Mixpanel.

Quick Clarity prompts: no skill file needed

For a one-time question, a plain prompt is enough once Claude can reach Clarity. Each one asks for a single result so it costs one request.

Prompt
In Microsoft Clarity, which 5 URLs had the most rage clicks in the last 3 days?
Prompt
In Microsoft Clarity, show scroll depth by device for the last 2 days.
Prompt
In Microsoft Clarity, break traffic down by channel for the last 3 days: sessions, bot sessions and users.
Prompt
In Microsoft Clarity, which browsers have the most script errors in the last 3 days?

Ask Claude how many Clarity requests it has made in the chat, because the project allows 10 a day.

Clarity limits every skill has to respect

  1. Requests

    Value
    10 per project per day
  2. History

    Value
    The previous 1 to 3 days
  3. Dimensions per request

    Value
    3
  4. Rows per response

    Value
    1,000, no pagination
  5. Time zone

    Value
    Results in UTC
  6. Token owner

    Value
    One token per project, created by a project admin
  7. Projects per Ryze AI connection

    Value
    1 Clarity project per workspace

Because of the last row, a second Clarity project goes in a second Ryze AI workspace. Switching projects in one workspace means disconnecting Clarity in the Ryze AI app and connecting the other token.

Troubleshooting: when a Clarity skill returns a wrong answer

Claude has no Clarity tool

Claude keeps the tool list from when you added the connector. If you connected Clarity afterwards, remove and re-add the Ryze AI connector, then start a new chat.

Clarity says the daily limit is exceeded

Clarity documents a 429 TooManyRequests error with the message Exceeded daily limit. The limit is 10 requests per project per day, so wait for the next day or use fewer calls per skill.

401 or 403 from Clarity

Clarity lists a missing, invalid or expired token as the reason for 401 and a token not authorized for the operation for 403. Generate a new token in Settings, Data Export.

The skill asks for weeks of data

Clarity serves the previous 1 to 3 days only. Use skill 08 to keep entries yourself.

The one-time connection link is refused

Clarity already has a connection in that workspace. Change projects in the Ryze AI app: disconnect, then connect again.

The page list looks cut off

A response is limited to 1,000 rows. Ask for one fewer dimension or a shorter page list.

Sources

The verdict

Turn each recurring Clarity question into a skill with a fixed call plan. Start with the friction digest and the paid landing page check, run the traffic sanity check before you trust a channel, and keep a snapshot log because Clarity will not.

Ryze AI runs these skills in Claude on live Clarity data through one read tool. It covers only the last 1 to 3 days and has no recordings or heatmaps, so deeper review still happens in Clarity.

Frequently asked questions

What are Claude skills for Microsoft Clarity?
SKILL.md files that tell Claude which Clarity metric to read, which dimensions to use and how to present the result. Claude loads one when a request matches its description, so each check runs the same way every time.
Do I need a Clarity connection to use these skills?
No. Each skill also works on numbers you paste from the Clarity dashboard if they cover the metrics the skill names. A connection removes the copy step.
Can Claude see my Clarity session recordings or heatmaps?
Not through Ryze AI. Its Clarity tool returns behavior metrics only, so the skills point you to the Clarity recordings and heatmaps filters. Microsoft's own MCP server documents session recording access.
How far back can these skills look?
The previous 1 to 3 days. That is the Clarity Data Export API window, and results come back in UTC. Skill 08 writes a log entry you keep to build a longer history.
Show 6 more questions
How many Clarity requests do the skills use?
Between 1 and 3 each, and Clarity allows 10 requests per project per day. Running all 8 skills in one day would need 16 requests, so spread them over days or run the ones you need.
Can Claude change my Clarity settings through these skills?
No. The Ryze AI Clarity tool is a read tool, so the connector does not change anything in Clarity. In Claude, per-tool approvals are under Customize, Connectors, Ryze AI, Tool permissions.
What Clarity access do I need?
A Data Export API token for the project, created in Settings, Data Export. Microsoft says only project admins can manage access tokens, so ask an admin if the option is missing.
Which Claude plan do I need?
Anthropic lists custom skill uploads on claude.ai for Pro, Max, Ultra, Team and Enterprise with code execution enabled. In Claude Code, skills are folders on your computer. Custom connectors are available on Free, Pro, Max, Ultra, Team and Enterprise, with Free limited to one.
What is the difference between a rage click and a dead click in Clarity?
Clarity defines a rage click as repeated clicks in a clustered area within a brief period, and a dead click as a click with no response. Skills 01 and 02 read both counts by page.
Should I use Ryze AI or Microsoft's Clarity MCP server?
Use Ryze AI to run these skills from one hosted URL with a token you paste once. Use Microsoft's server, which runs locally with Node.js and OAuth, when you want its recording and AI Visibility tools. The skills name metrics and dimensions, so they can be adapted to either.

Related guides

Ryze AI: Clarity skills on live data

7-day free trial, $89 a month flat

Start free trial