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.
Used by 2,000+ marketers
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.
- 01Friction digestDead clicks, rage clicks and quickbacks by page
Main Clarity fields: Dead Click Count, Rage Click Count, Quickback Click, URL
Calls: 2
- 02Rage click pagesWhich pages and devices carry the rage clicks
Main Clarity fields: Rage Click Count, URL, Device
Calls: 1
- 03Scroll and engagement gapScroll depth and engagement time by device
Main Clarity fields: Scroll Depth, Engagement Time, Device, URL
Calls: 2
- 04Paid landing page checkHow campaign visitors behave on their landing page
Main Clarity fields: Traffic, Scroll Depth, Rage Click Count, Campaign, URL
Calls: 3
- 05Error click checkScript errors and error clicks by browser and OS
Main Clarity fields: Script Error Count, Error Click Count, Browser, OS
Calls: 2
- 06Bot and traffic sanity checkSessions, bot sessions and users by channel
Main Clarity fields: Traffic, Channel, Source, Medium
Calls: 1
- 07Popular pages by channelMost visited pages and referrers per channel
Main Clarity fields: Popular Pages, Referrer URL, Channel
Calls: 2
- 08Snapshot logA paste-ready entry for a running log
Main Clarity fields: Traffic, Scroll Depth, Rage Click Count
Calls: 3
| # | Skill | Job | Main Clarity fields | Calls |
|---|---|---|---|---|
| 01 | Friction digest | Dead clicks, rage clicks and quickbacks by page | Dead Click Count, Rage Click Count, Quickback Click, URL | 2 |
| 02 | Rage click pages | Which pages and devices carry the rage clicks | Rage Click Count, URL, Device | 1 |
| 03 | Scroll and engagement gap | Scroll depth and engagement time by device | Scroll Depth, Engagement Time, Device, URL | 2 |
| 04 | Paid landing page check | How campaign visitors behave on their landing page | Traffic, Scroll Depth, Rage Click Count, Campaign, URL | 3 |
| 05 | Error click check | Script errors and error clicks by browser and OS | Script Error Count, Error Click Count, Browser, OS | 2 |
| 06 | Bot and traffic sanity check | Sessions, bot sessions and users by channel | Traffic, Channel, Source, Medium | 1 |
| 07 | Popular pages by channel | Most visited pages and referrers per channel | Popular Pages, Referrer URL, Channel | 2 |
| 08 | Snapshot log | A paste-ready entry for a running log | Traffic, Scroll Depth, Rage Click Count | 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.
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
Setup
- One-off prompt
- None
- Skill
- Save once per Claude app
- Clarity connection
- One Clarity API token, pasted into Ryze AI
Requests spent
- One-off prompt
- Whatever the chat needs
- Skill
- The number written in the file
- Clarity connection
- Counts against 10 a day
| One-off prompt | Skill | Clarity connection | |
|---|---|---|---|
| What it is | A question in chat | A saved file with a fixed call plan and output | A tool Claude uses to read Clarity |
| Setup | None | Save once per Claude app | One Clarity API token, pasted into Ryze AI |
| Requests spent | Whatever the chat needs | The number written in the file | 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.
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.
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.
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.
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.
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.
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.
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
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:
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
| Tool | What it returns | Used by |
|---|---|---|
| clarity__read | 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 | 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.
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
Requests
- Value
- 10 per project per day
- Source
- Clarity Data Export API
History
- Value
- The previous 1 to 3 days
- Source
- Clarity Data Export API
Dimensions per request
- Value
- 3
- Source
- Clarity Data Export API
Rows per response
- Value
- 1,000, no pagination
- Source
- Clarity Data Export API
Time zone
- Value
- Results in UTC
- Source
- Clarity Data Export API
Token owner
- Value
- One token per project, created by a project admin
- Source
- Clarity Data Export API
Projects per Ryze AI connection
- Value
- 1 Clarity project per workspace
- Source
- Ryze AI help center
| Limit | Value | Source |
|---|---|---|
| Requests | 10 per project per day | Clarity Data Export API |
| History | The previous 1 to 3 days | Clarity Data Export API |
| Dimensions per request | 3 | Clarity Data Export API |
| Rows per response | 1,000, no pagination | Clarity Data Export API |
| Time zone | Results in UTC | Clarity Data Export API |
| Token owner | One token per project, created by a project admin | Clarity Data Export API |
| Projects per Ryze AI connection | 1 Clarity project per workspace | Ryze AI help center |
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.





