agentleFS
Synter-Media-AISynter-Media-AI/free-skills/skills/tracking-leak-detector/SKILL.md

tracking-leak-detector

Skill4 starsChanged 6 months agoMITView on GitHub

Detect gaps between expected and actual conversion tracking across ad platforms (Meta, Google, LinkedIn, TikTok, Reddit) and CRMs. Surfaces blind spots in pixel/CAPI/Enhanced Conversions that silently erode ROAS measurement.

The file

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 1 is distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Call detect_tracking_leaks with days=30

    line 124
  2. Distinctive:

    If view-through blind spot detected, explain that LinkedIn VTCs may be uncounted

    line 127
  3. Very specific:

    Call attribution_health_check first for overall status

    line 133
  4. Very specific:

    Call detect_tracking_leaks for active issues

    line 134

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Tracking Leak Detector

Detects gaps between expected and actual conversion tracking across all ad platforms and CRMs. Surfaces blind spots that silently erode ROAS measurement.


When to Use This Skill

  • User asks "why are my conversions low?" or "is my tracking working?"
  • ROAS numbers seem unexpectedly low or inconsistent
  • A platform is spending money but showing 0 conversions
  • CRM shows more/fewer conversions than ad platforms report
  • Conversions suddenly dropped on a platform
  • User wants to audit their tracking setup before scaling spend
  • User mentions "tracking leaks" or "attribution gaps"

Agent Tools

This skill provides two agent tools:

detect_tracking_leaks

Analyzes the last N days of data to find:

Leak TypeWhat It Detects
zero_conversion_spendPlatforms spending money but reporting 0 conversions
crm_ad_mismatchCRM conversion count differs significantly from ad platform totals
conversion_dropSudden drop (>70%) in conversions vs prior period
utm_missingCRM contacts from paid sources without UTM campaign data
view_through_blind_spotPlatforms (Meta, LinkedIn, TikTok) with no impression tracking

Each leak includes a severity (critical/warning/info), description, estimated impact, and specific recommendation.

attribution_health_check

Comprehensive check of the full attribution pipeline:

CheckWhat It Validates
CRM ConnectionsHubSpot, Attio, Salesforce token status and data freshness
Ad Platform DataData freshness for all connected platforms
Conversion EventsWhether conversion events are being recorded
View-Through TrackingWhether impression/view events exist for VTC attribution
UTM CoveragePercentage of CRM contacts with campaign attribution

How Leaks Are Detected

1. Zero-Conversion Spend (Critical)

IF platform.spend > $100 AND platform.conversions == 0
THEN → Likely broken pixel or misconfigured conversion action

2. CRM-to-Ad Mismatch (Warning)

IF crm_conversions / ad_conversions > 1.5
THEN → Ads are under-reporting (UTM tracking gaps)

IF crm_conversions / ad_conversions < 0.5
THEN → Ads are over-counting (double-counting or CRM sync broken)

3. Conversion Drop (Critical)

IF current_period_conversions / prior_period_conversions < 0.3
THEN → 70%+ drop suggests broken tracking, not performance decline

4. UTM Missing (Warning)

IF contacts_from_paid_without_utm / total_contacts > 0.2
THEN → 20%+ of paid contacts have no campaign attribution

5. View-Through Blind Spot (Info)

IF platform IN (Meta, LinkedIn, TikTok, Pinterest)
   AND impression_events == 0
THEN → View-through conversions are not being captured

Supported CRMs

CRMRevenue SourceStatus
HubSpotDeal amounts from crm_events (deal_won)Active
AttioDeal/record values synced via APIActive
SalesforceOpportunity amountsActive

Supported Ad Platforms

PlatformConversion TrackingView-Through
Google AdsClick-throughN/A (handled by Google)
LinkedIn AdsClick-through + VTCSupported
Meta AdsClick-through + VTCSupported
Microsoft AdsClick-throughN/A
Reddit AdsClick-throughPlanned
X AdsClick-throughPlanned
TikTok AdsClick-through + VTCSupported
Amazon AdsClick-through + VTCSupported
StackAdaptClick-through + VTCSupported
The Trade DeskClick-through + VTCSupported

Example Usage

User: "My ROAS seems way too low on LinkedIn. Is something wrong with tracking?"

Agent should:

  1. Call detect_tracking_leaks with days=30
  2. Call attribution_health_check
  3. Report any leaks found, focusing on LinkedIn
  4. If view-through blind spot detected, explain that LinkedIn VTCs may be uncounted
  5. Provide specific remediation steps

User: "Run a tracking audit before I increase spend"

Agent should:

  1. Call attribution_health_check first for overall status
  2. Call detect_tracking_leaks for active issues
  3. Present a summary table of all findings
  4. Prioritize critical issues that should be fixed before scaling

Related Skills

  • conversion-tracking — Setup and verification of conversion pixels
  • 11-ad-platform-data — Pulling performance data from platforms
  • budget-optimizer — Budget allocation (depends on accurate attribution)

Last Updated: March 2026


About this skill

Part of the Synter free skills collection — open-source agent skills for advertising, PPC, and marketing automation.

Want this skill (and 40+ more) running on autopilot against your live ad accounts? Try Synter — AI Agent Media Buyers that connect to Google, Meta, LinkedIn, TikTok, Reddit, Amazon, and 7+ more platforms.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.