Agent skill · Data & Analytics

dark-social-attributor

Use when the user asks to "figure out where our direct traffic really comes from", "measure dark social", "add a how-did-you-hear-about-us field", or "show social drives signups without click data"; produces a share-link/UTM hygiene spec for owned share surfaces, a self-reported attribution field design that replaces an existing form field (free-text first, coded later), a GA4 direct-traffic decomposition read (deep-URL directs, mobile-app skew, private-push correlation) with every derived number hard-labeled Estimated/proxy, and a branded-search-lift proxy from GSC plus Wikipedia pageviews —

aaron-he-zhugithub.com/aaron-he-zhuGitHub ↗
claude-codeApache-2.0
Install
npx skills add aaron-he-zhu/aaron-marketing-skills --skill dark-social-attributor --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 1
SKILL.md size: 14 KB
Bundled scripts: none
Version: 19.1.0
Requires: Claude Code and compatible agent-skill hosts
Path: social/observe/dark-social-attributor/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 2,508
Language: Python
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Dark Social Attributor Makes the unmeasurable share loop estimable — honestly. Dark social is the traffic that arrives with no referrer because the link traveled through a DM, a group chat (微信群 / WhatsApp / Slack / Discord), a newsletter forward, or an address-bar copy. This skill declares the estimation method and specs the instrumentation; it never turns an estimate into a Measured number. It is the Observe-phase upstream of the ECHO **O** dark-social sub-items (see [echo-benchmark.md](../../../references/echo-benchmark.md)): *dark-social method declared and Estimated-labeled before any social-ROI claim* (ECHO O2) and the *dark-social instrumentation coverage* rows (ECHO O6–O7 — share-link/UTM hygiene live plus a self-reported attribution field running). Its labels are also what keeps the ECHO O1 denominator-integrity veto passable downstream: proxies pass when labeled proxy. **Scope guard**: this skill produces the dark-social method doc and instrumentation specs only. **Paid-channel attribution reconciliation — platform-claimed vs analytics conversions, dedup, incrementality — stays with [attribution-reconciler](../../../ad/scale/attribution-reconciler/SKILL.md)**; this skill

What's inside
Steps it walks through
  1. Quick Start
  2. Skill Contract
  3. Handoff Summary
  4. Data Sources
  5. Instructions
  6. Runtime Reads
  7. Procedure
  8. Save Results
  9. Reference Materials
  10. Next Best Skill
More from aaron-marketing-skills
All skills →
About this skill
What does the dark-social-attributor skill do?

Use when the user asks to "figure out where our direct traffic really comes from", "measure dark social", "add a how-did-you-hear-about-us field", or "show social drives signups without click data"; produces a share-link/UTM hygiene spec for owned share surfaces, a self-reported attribution field design that replaces an existing form field (free-text first, coded later), a GA4 direct-traffic decomposition read (deep-URL directs, mobile-app skew, private-push correlation) with every derived number hard-labeled Estimated/proxy, and a branded-search-lift proxy from GSC plus Wikipedia pageviews —

How do I install it?

Run `npx skills add aaron-he-zhu/aaron-marketing-skills --skill dark-social-attributor --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From aaron-he-zhu/aaron-marketing-skills, a repository with 2,508 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going