umami-setup

Automate Umami analytics integration with framework detection and conditional script injection.

1|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/Jeffreyyvdb/.dotfiles --skill umami-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umami-setup
Source: https://github.com/Jeffreyyvdb/.dotfiles/tree/main/.agents/skills/umami-setup
Command: npx skills add https://github.com/Jeffreyyvdb/.dotfiles --skill umami-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill addresses the challenge of manually integrating Umami analytics into web applications, providing a streamlined process with environment variable control for easy on/off toggling.

Core Features & Use Cases

  • Framework Detection: Automatically identifies the web framework (e.g., SvelteKit, Next.js, Nuxt, Astro, Vite, plain HTML).
  • Conditional Script Injection: Injects tracker scripts, Core Web Vitals collection, and optional session recorder based on environment variables.
  • Documentation & Verification: Includes detailed documentation and a verification process to ensure correct implementation.

Quick Start

Install the umami-setup skill and add Umami analytics to your project with a simple command.

Frequently Asked Questions about umami-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate Umami analytics into my web application?

To integrate Umami analytics, this skill automates script injection by detecting your web framework and using environment variables to conditionally add tracker scripts, Core Web Vitals collection, and optional session recording.

Does Umami analytics integration support frameworks like SvelteKit, Next.js, and Astro?

Yes, Umami analytics integration detects and supports multiple frameworks including SvelteKit, Next.js, Nuxt, Astro, Vite, and plain HTML, automatically adapting the script injection process for each environment.

How can I toggle Umami web analytics on and off in my application?

You can toggle Umami web analytics on and off using environment variables. This conditional script injection mechanism allows easy control over tracker scripts, Core Web Vitals collection, and session recording.

What do I need to set up before adding Umami analytics to my project?

You need an active Umami instance and specific environment variables configured for your web application. This prerequisite setup allows the skill to correctly route data and authenticate your analytics tracking.

How do I verify that Umami analytics is correctly tracking my web application?

You can verify correct Umami analytics implementation using the included documentation and verification process. This ensures the injected tracker scripts and Core Web Vitals collection are actively capturing data.

Can I collect Core Web Vitals and session recordings with Umami analytics?

Yes, you can collect Core Web Vitals and optional session recordings with Umami analytics. The integration conditionally injects these specific tracking scripts based on your environment variable configuration.