Connect

SyncMetrics skill for AI agents

The SyncMetrics Marketing Analyst is a free agent skill that teaches Claude (and other skill-capable agents) to use SyncMetrics' 106 tools like an expert — the right tool for each question, proper date comparisons, honest attribution caveats, and confirm-before-write safety.

Why install it

The connector gives your AI access to your data. The skill teaches it judgment:

Without the skillThe AI guesses which tool to use, mixes ad-platform and GA4 attribution, compares unequal date windows, and needs several prompt iterations.
With the skillOne prompt → first-attempt-correct analysis: cross-platform overview first, raw counts next to every rate, LOW SAMPLE flags, ranked recommendations, and a shareable dashboard or Sheets export offered at the end.

The skill is instructions only — it contains no credentials and makes no network calls itself. Data access still goes through your own OAuth session.

Prerequisites

A SyncMetrics account with at least one platform connected on your dashboard, and the connector added to your AI client — see Claude & AI clients.

Install in Claude (web & desktop)

1. Download the skill file: SKILL.md on GitHub (Download raw file).
2. In Claude, open Settings → Capabilities → Skills → Upload skill and select the file.
3. Start a new chat and ask a marketing question — the skill applies automatically.

Install in Claude Code (CLI)

git clone https://github.com/shamsuzzaman1/syncmetrics-skill
cp -r syncmetrics-skill/skills/syncmetrics-marketing-analyst ~/.claude/skills/

Restart Claude Code, then verify: "What does the syncmetrics-marketing-analyst skill do?"

Codex, Cursor & other agents

Copy the same folder into your agent's skills directory (~/.agents/skills/ for Codex, ~/.cursor/skills/ for Cursor), or paste the SKILL.md body into your agent's custom instructions.

What the skill covers

Tool selectionQuestion → tool map for all 106 tools: overviews, campaign drill-downs, breakdowns, custom reports with metric discovery, wasted-spend, keyword & reach planners, GA4, Shopify, exports.
Analysis conventionsExplicit date windows, equal comparison periods, raw n next to every rate, low-sample discipline, ad-platform vs GA4 vs Shopify attribution honesty, currency handling.
Write safetyGoogle Ads actions and Sheets writes always show a plan and get an explicit yes; new campaigns are created paused. Everything else is read-only.
Output standardTables + deltas + 3–5 ranked recommendations; offers a create_shareable_dashboard link or Sheets export to finish.

Try it

After installing, paste any recipe, or start with:

"Give me a weekly performance summary across all my connected ad accounts, with what changed vs the previous week and what to do next."

Previous← Claude & AI clients