gtm-debug-agent

What problem does it solve?

Manually debugging Google Tag Manager (GTM) configurations is a complex, time-consuming, and error-prone process. Verifying tag firing, dataLayer events, and consent mode across various user actions requires meticulous attention and often leads to missed issues. This Skill automates the entire GTM debugging workflow, ensuring your tracking is always accurate.

Core Features & Use Cases

• Automated GTM Debugging: Connects to GTM Preview mode, navigates to target URLs, executes test actions, and captures comprehensive data across Tags, Variables, Consent, and dataLayer.
• Visual Monitoring & Annotation: Automatically takes screenshots of the GTM debug panel and annotates successes (e.g., fired tags, matched variables) with red arrows for clear, visual reports.
• MCP Integration: Seamlessly integrates with google-tag-manager and Stape MCP servers for end-to-end container build validation and server-side tagging verification.
• Actionable Reports: Generates detailed pass/fail reports with fix recommendations, saving hours of manual analysis and accelerating issue resolution.
• Use Case: You've just implemented a new purchase event in GTM. Instead of manually clicking through the checkout flow and inspecting the debug panel, simply tell the AI: "Debug GTM-XXXXXXX on https://example.com/checkout, expecting 'purchase' event and 'GA4 - Purchase' tag to fire after clicking '#buy-button'". The skill will run the test, capture results, and provide an annotated report.

Quick Start

Ask the AI: Debug GTM-XXXXXXX on https://example.com/product-page, expecting 'page_view' event and 'GA4 - Page View' tag to fire.