gtm-dom-standardization

Standardize DOM identifiers and GTM tracking classes across HTML, JSX/TSX, and Vue projects.

3|1|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/aimonk2025/google-tag-manager-automation --skill gtm-dom-standardization
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gtm-dom-standardization
Source: https://github.com/aimonk2025/google-tag-manager-automation/tree/main/skills/gtm-dom-standardization
Command: npx skills add https://github.com/aimonk2025/google-tag-manager-automation --skill gtm-dom-standardization

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Standardizes all click-related IDs and CSS classes across the codebase to ensure reliable analytics tracking with GTM/GA4, reducing naming drift and data inconsistencies.

Core Features & Use Cases

  • Detects interactive elements (buttons, links, forms, media) and assigns consistent IDs and tracking classes without altering visuals.
  • Applies the naming convention for IDs and classes (IDs: cta_{location}_{descriptor}; Classes: js-track js-{category} js-{action} js-{location}).
  • Supports phase-based workflows including analysis, categorization, standardization, and validation on HTML/JSX/TSX/Vue.

Quick Start

Run the DOM standardization workflow on your codebase to apply analytics-ready IDs and tracking classes while preserving existing styles.

Frequently Asked Questions about gtm-dom-standardization

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

FAQPage Schema
How do I standardize DOM IDs and tracking classes for GTM across my codebase?

To standardize DOM IDs and tracking classes for GTM, you can run a phase-driven workflow that analyzes and categorizes interactive elements, applying consistent naming conventions like cta_{location}_{descriptor} for IDs and js-track classes for reliable analytics tracking.

What naming conventions should I use for GA4 click tracking classes and element IDs?

For GA4 click tracking, use the ID format cta_{location}_{descriptor} and the class format js-track js-{category} js-{action} js-{location}. This ensures consistent dataLayer keys and reliable selectors across your codebase.

Does DOM standardization for GTM work with JSX, TSX, and Vue files?

DOM standardization for GTM supports HTML, JSX, TSX, and Vue projects. It detects interactive elements like buttons and forms during audits or refactors, assigning standard tracking classes while preserving existing styling.

Why are my GA4 event tags firing inconsistently despite having CSS classes on buttons?

Inconsistent GA4 event tracking often stems from naming drift in DOM identifiers. Standardizing tracking classes and applying disciplined naming conventions like js-track js-{category} ensures dataLayer keys remain uniform across deployments.

Can I add analytics tracking classes to elements without altering existing visual styling?

You can add analytics tracking classes without altering visual styling by applying the standardization workflow. It assigns js-track classes and consistent IDs to interactive elements while explicitly preserving all existing CSS and visual layouts.

What is the workflow for auditing and standardizing dataLayer keys and selectors during a refactor?

The workflow for auditing dataLayer keys during a refactor involves four phases: analysis, categorization, standardization, and validation. It detects interactive elements and applies consistent ID and class naming conventions for reliable GTM tracking.