How do I install the Umami Foundation skill?

Run npx skillmds@latest add ryan-brosas/umami-foundation in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Umami Foundation safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Umami Foundation?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Umami Foundation free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Umami Foundation?

ryan-brosas (@ryan-brosas) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Umami Foundation by ryan-brosas — Agent Skill

Name: Umami Foundation
Author: ryan-brosas

Umami Foundation

Use when porting privacy-first analytics/telemetry machinery — cookieless derived session identity, rolling cache-token handshakes for anonymous ingest, dual-backend SQL dispatch (Postgres + ClickHouse), dynamic filter compilation with typed bind placeholders, Kafka wire-size batching, soft-delete read caches, 2FA with partial-auth tokens and replay ledgers, rrweb session-replay chunking/reassembly, heatmap capture with scroll bucketing, hand-rolled Core Web Vitals, and share-token capability grants.

ryan-brosas eedf339 34 files · 97.0 KB Updated Sep 17, 2026

File contents

umami: privacy-first web analytics platform

Foundation contract

This is a cold, source-specific foundation, not an operational procedure. It is historical, revision-pinned evidence rather than timeless guidance. Current project source, tests, requirements, and runtime behavior outrank this projection and decide what ships.

Provenance and revision

Source record: umami; portable upstream identity, license, coverage caveats, and retrieval history are preserved in the index.
Recorded revision: master@ca661c7057984aa98ed4f7083d84dae2f65bfcb0.
Full provenance, coverage caveats, boundaries, and preserved evidence: references/index.md.

Topic map

Representative topics: Identity & sessions; Auth & 2FA; Query engine; Ingest pipeline; Streaming infra; Tracker (browser); Session replay; Heatmap.
Scope and retrieval questions: references/index.md#use-this-for.
Complete capsule chooser: references/index.md#load-the-matching-source-dump.
Detailed grouped map: references/index.md#capsule-map.
Source limitations and portability boundaries: references/index.md#boundaries.

Retrieval

Open the index, choose one capsule matching the active question, and load only that capsule. Revalidate its cited source and revision before relying on it. Do not bulk-load the inventory, treat historical claims as current truth, or apply this foundation as a procedure.

Frequently asked questions