Skill

clarity

Agent-native CLI for Microsoft Clarity browser-analytics instrumentation. Generates Clarity install snippets, custom-identifier calls, audits local HTML for Clarity tags before deployment, and fetches the Data Export API (Microsoft caps it at 10 requests/project/day). Read-only by default — never mutates remote resources.

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use clarity

Choose if

You're instrumenting Microsoft Clarity from an agent loop and want generated install snippets, pre-deploy HTML audits, and access to the Data Export API behind typed exit codes — without writing the Clarity boilerplate yourself or hand-rolling a fetch wrapper. Prefer this over copying the snippet from Microsoft's docs when the workflow benefits from agent-replayable steps.

Avoid if

You need write operations against Clarity (the CLI is read-only by design) or your workload exceeds 10 Data Export requests per project per day. Also avoid if you're using a non-Clarity analytics vendor (GA4, Plausible, PostHog) — this skill is Clarity-specific.

Risk Flags

  • MEDIUM rate_limit Microsoft caps the Data Export API at 10 requests per project per day. Heavy export workloads must batch and cache locally — the CLI surfaces this as exit code 7 but cannot lift the upstream quota.
  • LOW scope Read-only by default — no create / update / delete / publish / send / mutate. Agents needing to push data back into Clarity must use the Clarity web UI.
  • LOW data_quality Common failure modes documented in the README: no sessions appear after install (script wiring issue), or sensitive content appears masked / unmasked unexpectedly (Clarity data-masking config).

Cost

Type: Free · Free tier: The CLI binary is MIT-licensed and free to install. Microsoft Clarity itself is free; no API key required for the documented client API. The Data Export API is read-only but quota-limited by Microsoft to 10 requests per project per day.

Install

Default

npx -y @mvanhorn/printing-press install clarity

Setup docs →

Estimated time to first success: ~5 min

Dependencies

Minimum runtime: Node.js (for npx install) or Go 1.23+ (source install)

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT