Agent skill

Traffic Analysis

by kostja94 in kostja94/marketing-skills

When the user wants to analyze website traffic sources, attribution, or dark traffic.

MITAuto-check passedMarketing & SEO

Install Traffic Analysis

skills CLI
$ npx skills add kostja94/marketing-skills --skill traffic-analysis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install kostja94/marketing-skills traffic-analysis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/kostja94/marketing-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/analytics/sources/traffic .claude/skills/traffic-analysis && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
traffic-analysis
GitHub stars
1k
Token cost
~1.9k tokens
SKILL.md length
763 words
Files
1
Skills in repo
102
Repo updated
First seen
Licence
MIT

At a glance

When the user wants to analyze website traffic sources, attribution, or dark traffic.

  • Works in 3 steps: Expected direct: Homepage, short URLs,… → Unexpected direct: Long URLs, deep… → Report separately: Use segments in…
  • Wants to analyze website traffic sources
  • SKILL.md covers Scope, Branded vs. Non-Branded…, Bot Traffic and Traffic Channels, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Traffic Analysis is an agent skill from kostja94/marketing-skills. When the user wants to analyze website traffic sources, attribution, or dark traffic. Also use when the user mentions "traffic sources," "dark traffic," "direct traffic," "UTM parameters," "traffic attribution," "channel attribution," "attribution optimization," "channel analysis," "traffic analysis," "traffic diversification," "natural traffic benchmark," or "organic vs paid traffic." For GA4 setup, use analytics-tracking.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Marketing analytics and Product analytics. It works with Google Analytics. The repository describes itself as: Agent Skills for Marketing — SEO, Social, Influencer & More. 160+ open-source skills for SEO, content, 40+ page types, paid ads, channels, and strategies. Add project context… The licence is MIT.

When your agent uses it

  • Wants to analyze website traffic sources
  • The user mentions traffic sources
  • Traffic attribution
  • Channel attribution

Example prompts

  • “traffic sources,”
  • “dark traffic,”
  • “direct traffic,”
  • “/traffic-analysis”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Expected direct: Homepage, short URLs, brand pages--likely real direct
  2. Unexpected direct: Long URLs, deep pages, product pages--likely dark traffic
  3. Report separately: Use segments in GA4/analytics to avoid overcounting direct

What it can do on your machine

Read from SKILL.md and the folder at commit 8dd89c5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • web.utm.io
    • support.google.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Traffic Analysis loads about 1.9k tokens when it runs. Until then it costs about 111 tokens; SKILL.md has 763 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~111
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from kostja94/marketing-skills at commit 8dd89c5, republished under its MIT licence (© kostja94). 763 words, ~1,862 tokens.

Download SKILL.mdSave it as .claude/skills/traffic-analysis/SKILL.md (or your agent's skills folder).
name
traffic-analysis
description
When the user wants to analyze website traffic sources, attribution, or dark traffic. Also use when the user mentions "traffic sources," "dark traffic," "direct traffic," "UTM parameters," "traffic attribution," "channel attribution," "attribution optimization," "channel analysis," "traffic analysis," "traffic diversification," "natural traffic benchmark," or "organic vs paid traffic." For GA4 setup, use analytics-tracking.
metadata.version
1.1.1

Analytics: Traffic

Guides website traffic analysis across all channels (organic, paid, social, referral, direct). Covers traffic source attribution, dark traffic identification, and multi-channel reporting.

When invoking: On first use, if helpful, open with 1-2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.

Scope

  • Traffic sources: Organic, paid, social, referral, direct, email
  • Dark traffic: Unattributed visits labeled as "Direct / None"
  • Attribution: UTM tagging, segmenting, reporting accuracy

Branded vs. Non-Branded Traffic (Organic)

TypeCharacteristics
BrandedHigher CTR, conversion, purchase intent; users closer to funnel bottom
Non-brandedTouchpoint with future users; most sites get more non-brand traffic; competition fiercer

Brand traffic grows over time as brand awareness increases.

Bot Traffic

A large share of traffic can be bot traffic—RPA, search crawlers, spiders, scrapers. Exclude or segment when evaluating real user behavior; use GA4 filters or segments to isolate human traffic.

Traffic Channels

ChannelTypical SourcesAttribution
OrganicGoogle, Bing, other searchReferrer preserved
Paid (web)Google Ads, Meta Ads, etc.UTM required
Paid (app)App install ads; Google App Campaigns, Apple Search AdsUTM; in-app events
Paid (TV/CTV)Streaming ads; Hulu, Roku, YouTube TVUTM for QR/URL; brand lift
SocialPublic posts (Facebook, LinkedIn, etc.)Often preserved
ReferralExternal sites, backlinksReferrer preserved
DirectTyped URL, bookmarksNo referrer
EmailNewsletters, campaignsOften dark without UTM

Dark Traffic

What It Is

Traffic without clear origin--analytics tools default to "Direct" when referrer is missing. Common causes:

  • Private/dark social: WhatsApp, Messenger, Slack, Discord, TikTok shares
  • Email clients: Many strip referrer headers
  • HTTPS->HTTP: Referrer not passed
  • Mobile apps: In-app browsers often omit referrer
  • Ad blockers, privacy tools: Block tracking
Misattribution (Research)

When traffic was sent from known sources, analytics often misattributed:

  • 100% as direct: TikTok, Slack, Discord, WhatsApp, Mastodon
  • 75%: Facebook Messenger
  • 30%: Instagram DMs
  • 14%: LinkedIn public posts
  • 12%: Pinterest
Mitigation
ActionPurpose
UTM parametersTag links in emails, social, campaigns: ?utm_source=X&utm_medium=Y&utm_campaign=Z
Block internal IPsExclude company visits from reports
Segment direct trafficSplit by page type to estimate dark vs. genuine direct
Segmenting Direct Traffic
  1. Expected direct: Homepage, short URLs, brand pages--likely real direct
  2. Unexpected direct: Long URLs, deep pages, product pages--likely dark traffic
  3. Report separately: Use segments in GA4/analytics to avoid overcounting direct

Attribution for Channel Optimization

Ads, growth channels, and medium can be optimized by viewing attribution data. Clean UTM + conversion tracking feeds attribution models; reliable attribution drives budget allocation and channel decisions.

UseAction
Optimize adsCompare paid channels (Google, Meta, LinkedIn) by attributed conversions; reallocate budget to winners
Optimize growth channelsIdentify which medium (cpc, email, social, referral) drives conversions; scale what works
Multi-touch attributionRequires clean UTM data; inconsistent tagging (e.g., facebook vs Facebook) fragments reports and misattributes

GA4 Default Channel Grouping: Align utm_medium and utm_source with GA4's rules to avoid "Unassigned" traffic. ~30% of campaigns lack proper UTM markup, leading to wasted ad spend; teams standardizing UTM see 29% improvement in attribution accuracy.

Reference: UTM.io – utm_medium, utm_campaign & utm_source Optimization, UTMs for Marketing Attribution

Show full SKILL.md (252 more words)Show less

UTM Best Practices

ParameterUseExample
utm_sourceOriginnewsletter, facebook, google
utm_mediumChannel typeemail, cpc, social
utm_campaignCampaign namesummer_sale, product_launch
utm_contentVariant (optional)banner_a, cta_button
utm_termPaid keyword (optional)running_shoes

GA4 alignment (avoid Unassigned):

Channelutm_mediumutm_source
Paid Searchcpcgoogle, bing
Paid Socialpaid-social, cpcfacebook, instagram
Emailemailnewsletter, mailchimp
Organic Socialsocialtwitter, linkedin
App installcpc, appgoogle, facebook, apple
CTV / Streamingvideo, ctvhulu, roku, youtube
Display / Bannerdisplay, cpcPublisher or network name
Directory adspaid, cpctaaft, shopify, g2, capterra
  • Consistent naming: Lowercase, hyphens; document conventions; never tag internal links (overwrites session attribution)
  • Apply everywhere: Every link in emails, social posts, ads
  • Avoid: Typos, inconsistent values; causes fragmentation

Traffic Diversification

PrincipleGuideline
Search shareKeep organic search below ~75% of total traffic
HealthHigher direct + referral share = healthier profile
Brand sitesDiversified traffic is common for strong brands
EngagementContent, email, social, free tools drive return visits

See seo-monitoring for full SEO data analysis framework.

Natural Traffic Benchmark

Location: GA4 > Reports > Acquisition > Traffic acquisition

  1. Review organic traffic trend
  2. Record baseline (e.g., monthly total)
  3. Compare periodically to detect growth or decline

Output Format

  • Traffic source breakdown
  • Dark traffic estimate and actions
  • UTM tagging recommendations
  • Segmentation approach for reporting
  • analytics-tracking: Implement UTM, events, conversions; attribution models
  • google-ads, paid-ads-strategy: Paid channels; attribution informs budget allocation
  • ai-traffic-tracking: AI search traffic
  • google-search-console: GSC performance and indexing analysis
  • seo-monitoring: Full SEO data analysis system, benchmark, article database
  • email-marketing: Email strategy; UTM for email links

© kostja94, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/analytics/sources/traffic of kostja94/marketing-skills.

Open the folder on GitHubat commit 8dd89c5

Compare with similar skills

Traffic Analysis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Traffic Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Traffic Analysis this skillkostja94/marketing-skills1k—~1.9kAutomated safety check: PassMIT
AnalyticsNexus-JPF/note-companion8707 repos~2.2kAutomated safety check: PassMIT
Analytics Trackingborghei/Claude-Skills886—~5.7kAutomated safety check: PassMIT
Analytics Trackingfreekmurze/dotfiles1k12 repos~2kAutomated safety check: PassNone
Analytics Trackingalirezarezvani/claude-skills28k1 repos~3.8kAutomated safety check: PassMIT
Data And Funnel Analyticsmanojbajaj95/claude-gtm-plugin105—~2.9kAutomated safety check: PassMIT

Similar skills

  • Analytics

    Nexus-JPF/note-companion

    When the user wants to set up, improve, or audit analytics tracking and measurement.

    870 GitHub starsUsed in 7 repos~2.2k tokens
    Marketing & SEOAuto-check passed
  • Analytics Tracking

    borghei/Claude-Skills

    End-to-end analytics implementation for web and SaaS: GA4, Google Tag Manager, event taxonomy, conversion tracking, and UTM strategy.

    886 GitHub stars~5.7k tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Analytics Tracking

    freekmurze/dotfiles

    When the user wants to set up, improve, or audit analytics tracking and measurement.

    1k GitHub starsUsed in 12 repos~2k tokens
    Data & AnalyticsAuto-check passed
  • Analytics Tracking

    alirezarezvani/claude-skills

    Set up, audit, and debug analytics tracking implementation — GA4, Google Tag Manager, event taxonomy, conversion tracking, and data quality.

    28k GitHub starsUsed in 1 repo~3.8k tokens
    Data & AnalyticsAuto-check passed
  • Data And Funnel Analytics

    manojbajaj95/claude-gtm-plugin

    Analytics tracking, interpretation, funnel analysis, product metrics, and ROI measurement.

    105 GitHub stars~2.9k tokensUpdated 20 days ago
    Data & AnalyticsAuto-check passed
  • Google SEO APIs

    AgriciDaniel/claude-seo

    Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.

    19k GitHub starsUsed in 1 repo~4.2k tokens
    Marketing & SEOAuto-check passed

More from kostja94/marketing-skills

All 102 skills in this repo
  • Grokipedia Recommendations

    kostja94/marketing-skills

    When the user wants to add recommendations, links, or content to Grokipedia.

    1k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AI Traffic Tracking

    kostja94/marketing-skills

    When the user wants to track AI search traffic in GA4 or GSC.

    1k GitHub stars~959 tokensUpdated 3 days ago
    Auto-check passed
  • Analytics Tracking

    kostja94/marketing-skills

    When the user wants to set up, audit, or optimize analytics tracking (GA4, events, conversions).

    1k GitHub stars~1.5k tokensUpdated 3 days ago
    Auto-check passed
  • Brand Visual Generator

    kostja94/marketing-skills

    When the user wants to define, audit, or apply visual identity (typography, colors, spacing, design tokens, frontend aesthetics).

    1k GitHub stars~3k tokensUpdated 3 days ago
    Auto-check passed
  • Canonical Tag

    kostja94/marketing-skills

    When the user wants to configure canonical URLs, fix duplicate content, or consolidate URL signals.

    1k GitHub stars~1.2k tokensUpdated 3 days ago
    Auto-check passed
  • Content Strategy

    kostja94/marketing-skills

    When the user wants to plan content for SEO, create content calendar, or build topic clusters.

    1k GitHub stars~1.8k tokensUpdated 3 days ago
    Auto-check passed

Categories

Questions about Traffic Analysis

What does Traffic Analysis do?

When the user wants to analyze website traffic sources, attribution, or dark traffic. Traffic Analysis is an agent skill from kostja94/marketing-skills. When the user wants to analyze website traffic sources, attribution, or dark traffic.

When should I use Traffic Analysis?

Traffic Analysis fits situations like: wants to analyze website traffic sources; the user mentions traffic sources; traffic attribution; channel attribution.

How do I install Traffic Analysis in Claude Code?

Run `npx skills add kostja94/marketing-skills --skill traffic-analysis -a claude-code`. Or copy the skill folder (skills/analytics/sources/traffic in kostja94/marketing-skills) into .claude/skills/traffic-analysis in your project. Claude Code loads it when a task matches its description.

How do I install Traffic Analysis in Codex?

Run `npx skills add kostja94/marketing-skills --skill traffic-analysis -a codex`. Or copy the skill folder (skills/analytics/sources/traffic in kostja94/marketing-skills) into .agents/skills/traffic-analysis in your project. Codex loads it when a task matches its description.

Can I use Traffic Analysis in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kostja94/marketing-skills --skill traffic-analysis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/traffic-analysis, .gemini/skills/traffic-analysis, .github/skills/traffic-analysis and .opencode/skills/traffic-analysis in your project.

What does Traffic Analysis need to run?

SKILL.md names no scripts, command-line tools or credentials: Traffic Analysis is instructions for the agent only.

Does Traffic Analysis access the network?

SKILL.md names 2 domains. As links in the text: web.utm.io and support.google.com. This is read from the text; nothing was executed.

Is Traffic Analysis safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Traffic Analysis use?

Traffic Analysis is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Traffic Analysis use?

About 1.9k tokens (SKILL.md is roughly 7.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Traffic Analysis?

Skills that share tags, products or a category with Traffic Analysis: Analytics (Nexus-JPF/note-companion, 870 stars), Analytics Tracking (borghei/Claude-Skills, 886 stars), Analytics Tracking (freekmurze/dotfiles, 1k stars) and Analytics Tracking (alirezarezvani/claude-skills, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Traffic Analysis?

kostja94 (a GitHub user) maintains it in kostja94/marketing-skills, which has 1,025 GitHub stars. The repository holds 102 skills in this directory. The repository was last updated on October 6, 2026.

Source: kostja94/marketing-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.