conversion-debug — Claude Code skill for conversion tracking
Investigate tracking discrepancies across GTM, GA4, and ad platforms. Connected Cogny integrations let the skill check account data directly.
npx skills add cognyai/claude-code-marketing-skills --skill conversion-debug -a claude-codeWhat conversion-debug does
The skill helps investigate duplicate purchases, incorrect conversion values, enhanced conversion setup, and Consent Mode v2. It draws on reference guidance, diagnostic flowcharts, and BigQuery validation SQL. When integrations are connected, it can also query GTM, GA4, and advertising accounts.
Checks include comparing conversions across platforms, inspecting tags, and reconciling reports with Shopify or WooCommerce orders. Live account checks require Cogny MCP and the relevant connected integrations. Without that connection, the reference material, flowcharts, and SQL remain available, but account data cannot be queried.
What it helps with
- trace conversion count differences between GA4 and an ad platform
- check whether purchase events are counted twice
- investigate incorrect conversion values
- compare GA4 events with store orders
- audit a Consent Mode v2 setup
Example prompts for the agent
- Find out why GA4 and Google Ads report different conversion totals.
- Check whether the purchase event fires more than once.
- Compare GA4 purchases with Shopify orders.
How to install conversion-debug
1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill conversion-debug -a claude-code2Manually: put the files in place
~/.claude/skills/conversion-debug/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/conversion-debug/
1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill conversion-debug -a codex2Manually: put the files in place
.agents/skills/conversion-debug/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill conversion-debug -a cursor2Manually: put the files in place
.cursor/skills/conversion-debug/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cognyai/claude-code-marketing-skills conversion-debug2Manually: put the files in place
.github/skills/conversion-debug/SKILL.md1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill conversion-debug -a gemini-cli2Platform CLI
gemini skills install https://github.com/cognyai/claude-code-marketing-skills --path skills/conversion-debugManually: put the files in place
.devin/skills/conversion-debug/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill conversion-debug -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about conversion-debug
How do I install conversion-debug in Claude Code?
Run npx skills add cognyai/claude-code-marketing-skills --skill conversion-debug -a claude-code.
What does conversion-debug do?
It helps investigate conversion tracking issues, including platform discrepancies, duplicate events, and incorrect values. With connected integrations, it can query account data.
Does it need Cogny MCP to inspect account data?
Yes. Connect Cogny MCP and the relevant integrations for live checks. The reference material, flowcharts, and BigQuery SQL can still be used without them.
