Agent skill

Agent Analytics

by davepoon in davepoon/buildwithclaude

Analytics your AI agent can actually use. An agent skill from davepoon/buildwithclaude.

MITAuto-check passed

Install Agent Analytics

skills CLI
$ npx skills add davepoon/buildwithclaude --skill agent-analytics -a claude-code

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

GitHub CLI
$ gh skill install davepoon/buildwithclaude agent-analytics --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/davepoon/buildwithclaude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/all-skills/skills/agent-analytics .claude/skills/agent-analytics && 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
agent-analytics
GitHub stars
3.6k
Used in
1 other repo
Token cost
~2k tokens
SKILL.md length
675 words
Files
1
Skills in repo
245
Repo updated
First seen
Licence
MIT

At a glance

Analytics your AI agent can actually use. An agent skill from davepoon/buildwithclaude.

  • Works in 3 steps: Add the tracking snippet → Add custom events to important actions → Test immediately
  • SKILL.md covers When to Use This Skill, Philosophy, First-time setup and Step 1: Add the tracking snippet, plus 8 more sections
  • Calls npx

What it does

Agent Analytics is an agent skill from davepoon/buildwithclaude. Analytics your AI agent can actually use. Track, analyze, run A/B experiments, and optimize across all your projects via CLI. Includes a growth playbook so your agent knows HOW to grow, not just what to track.

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

It works with GitHub. The repository describes itself as: A single hub to find Claude Skills, Agents, Commands, Hooks, Plugins, and Marketplace collections to extend Claude Code, Claude Desktop, Agent SDK and OpenClaw. The licence is MIT.

Example prompts

  • “Use the agent-analytics skill to analytic your AI agent can actually use. An agent skill from davepoon/buildwithclaude”
  • “/agent-analytics”

Requirements

  • Node.js
  • A credential in AGENT_ANALYTICS_API_KEY

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Add the tracking snippet
  2. Add custom events to important actions
  3. Test immediately

What it can do on your machine

Read from SKILL.md and the folder at commit 10bfc43. 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

    Shell commands in SKILL.md call:

    • npx

    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):

    • agentanalytics.sh
    • github.com
    • docs.agentanalytics.sh

    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

Agent Analytics loads about 2k tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 675 words of instructions outside code blocks.

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

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 davepoon/buildwithclaude at commit 10bfc43, republished under its MIT licence (© davepoon). 675 words, ~2,033 tokens.

Download SKILL.mdSave it as .claude/skills/agent-analytics/SKILL.md (or your agent's skills folder).
name
agent-analytics
description
Analytics your AI agent can actually use. Track, analyze, run A/B experiments, and optimize across all your projects via CLI. Includes a growth playbook so your agent knows HOW to grow, not just what to track.
category
analytics
requires.env
AGENT_ANALYTICS_API_KEY
requires.bins
npx

Agent Analytics — Analytics your agent can actually use

You are adding analytics tracking using Agent Analytics — the analytics platform your AI agent can actually use. Built for developers who ship lots of projects and want their AI agent to track, analyze, experiment, and optimize across all of them.

Website: agentanalytics.sh GitHub: Agent-Analytics/agent-analytics Docs: docs.agentanalytics.sh

When to Use This Skill

  • User wants to add analytics tracking to a website or app
  • User wants to check how their projects are doing (traffic, conversions, engagement)
  • User wants to run A/B experiments on headlines, CTAs, or flows
  • User wants funnel analysis, retention cohorts, or traffic breakdowns
  • User asks "how's my site doing?" or "are people visiting?"

Philosophy

You are NOT Mixpanel. Don't track everything. Track only what answers: "Is this project alive and growing?"

For a typical site, that's 3-5 custom events max on top of automatic page views.

First-time setup

Get an API key: Sign up at agentanalytics.sh and generate a key from the dashboard. Alternatively, self-host the open-source version from GitHub.

If the project doesn't have tracking yet:

bash
# 1. Login (one time — uses your API key)
npx @agent-analytics/cli login --token aak_YOUR_API_KEY

# 2. Create the project (returns a project write token)
npx @agent-analytics/cli create my-site --domain https://mysite.com

# 3. Add the snippet using the returned token
# 4. Deploy, click around, verify:
npx @agent-analytics/cli events my-site

The create command returns a project write token — use it as data-token in the snippet. This is separate from your API key (which is for reading/querying).

Step 1: Add the tracking snippet

The create command returns a tracking snippet with your project token — add it before </body>. It auto-tracks page_view events with path, referrer, browser, OS, device, screen size, and UTM params. You do NOT need to add custom page_view events.

Step 1b: Discover existing events (existing projects)

If tracking is already set up, check what events and property keys are already in use so you match the naming:

bash
npx @agent-analytics/cli properties-received PROJECT_NAME

Step 2: Add custom events to important actions

Use onclick handlers on the elements that matter:

html
<a href="..." onclick="window.aa?.track('EVENT_NAME', {id: 'ELEMENT_ID'})">
Standard events for 80% of SaaS sites

Pick the ones that apply. Most sites need 2-4:

EventWhen to fireProperties
cta_clickUser clicks a call-to-action buttonid (which button)
signupUser creates an accountmethod (github/google/email)
loginUser returns and logs inmethod
feature_usedUser engages with a core featurefeature (which one)
checkoutUser starts a payment flowplan (free/pro/etc)
errorSomething went wrong visiblymessage, page
What NOT to track
  • Every link or button (too noisy)
  • Scroll depth (not actionable)
  • Form field interactions (too granular)
  • Footer links (low signal)
Property naming rules
  • Use snake_case: hero_get_started not heroGetStarted
  • The id property identifies WHICH element: short, descriptive
  • Name IDs as section_action: hero_signup, pricing_pro, nav_dashboard
Show full SKILL.md (269 more words)Show less

Step 2b: Run A/B experiments

Experiments let you test which variant of a page element converts better. The full lifecycle is API-driven — no dashboard UI needed.

Creating an experiment
bash
npx @agent-analytics/cli experiments create my-site \
  --name signup_cta --variants control,new_cta --goal signup
Implementing variants

Declarative (recommended): Use data-aa-experiment and data-aa-variant-{key} HTML attributes. Original content is the control. The tracker swaps text for assigned variants automatically.

html
<h1 data-aa-experiment="signup_cta" data-aa-variant-new_cta="Start Free Trial">Sign Up</h1>

Programmatic (complex cases): Use window.aa?.experiment(name, variants) — deterministic, same user always gets same variant.

Checking results
bash
npx @agent-analytics/cli experiments get exp_abc123

Returns Bayesian probability_best, lift, and a recommendation. The system needs ~100 exposures per variant before results are significant.

Step 3: Test immediately

After adding tracking, verify it works:

bash
# Click around, then check:
npx @agent-analytics/cli events PROJECT_NAME
# Events appear within seconds.

CLI Reference

All commands use npx @agent-analytics/cli:

bash
# Setup
login --token aak_YOUR_KEY           # Save API key (one time)
projects                              # List all projects
create my-site --domain https://...   # Create project

# Real-time
live                                  # Live TUI dashboard across ALL projects
live my-site                          # Live view for one project

# Analytics
stats my-site --days 7                # Overview: events, users, daily trends
insights my-site --period 7d          # Period-over-period comparison
breakdown my-site --property path --event page_view --limit 10  # Top pages/referrers/UTM
pages my-site --type entry            # Landing page performance & bounce rates
sessions-dist my-site                 # Session engagement histogram
heatmap my-site                       # Peak hours & busiest days
events my-site --days 30              # Raw event log
sessions my-site                      # Individual session records
properties my-site                    # Discover event names & property keys
funnel my-site --steps "page_view,signup,purchase"  # Funnel drop-off
retention my-site --period week --cohorts 8         # Cohort retention

# A/B experiments
experiments list my-site
experiments create my-site --name signup_cta --variants control,new_cta --goal signup
experiments get exp_abc123
experiments complete exp_abc123 --winner new_cta

Which endpoint for which question

User asksCallWhy
"How's my site doing?"insights + breakdown + pages (parallel)Full weekly picture
"Is anyone visiting right now?"liveReal-time visitors across all projects
"What are my top pages?"breakdown --property path --event page_viewRanked page list
"Where's my traffic coming from?"breakdown --property referrer --event page_viewReferrer sources
"Are people actually engaging?"sessions-distBounce vs engaged split
"When should I deploy?"heatmapFind low-traffic windows
"Where do users drop off?"funnel --steps "page_view,signup,purchase"Step-by-step conversion
"Are users coming back?"retention --period week --cohorts 8Cohort retention
"Which CTA converts better?"experiments create + experiments getA/B test lifecycle

For any "how is X doing" question, always call insights first — it's the single most useful endpoint.

Examples

Track custom events via window.aa?.track():

js
window.aa?.track('cta_click', {id: 'hero_get_started'});
window.aa?.track('signup', {method: 'github'});
window.aa?.track('feature_used', {feature: 'create_project'});
window.aa?.track('checkout', {plan: 'pro'});

What this skill does NOT do

  • No GUI dashboards — your agent IS the dashboard (or use live for a real-time TUI)
  • No user management or billing
  • No PII stored — IP addresses are not logged or retained. Privacy-first by design

© davepoon, 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 plugins/all-skills/skills/agent-analytics of davepoon/buildwithclaude.

Open the folder on GitHubat commit 10bfc43

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in davepoon/buildwithclaude, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Agent Analytics 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.

Agent Analytics compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agent Analytics this skilldavepoon/buildwithclaude3.6k1 repos~2kAutomated safety check: PassMIT
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Diagnosing Superpowers Sessionsobra/superpowers296k3 repos~1.7kAutomated safety check: PassMIT
GitHub Deep Researchbytedance/deer-flow83k5 repos~1.3kAutomated safety check: PassMIT
Greplooponyx-dot-app/onyx32k4 repos~3.3kAutomated safety check: PassMIT
Update V8 Versionopeninterpreter/openinterpreter69k2 repos~845Automated safety check: PassApache-2.0

Similar skills

  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Investigates a session where Superpowers went wrong, reads the transcripts on disk and produces an evidence-cited report, optionally prepared as a bug report for the maintainers.

    296k GitHub starsUsed in 3 repos~1.7k tokens
    Agent WorkflowsAuto-check passed
  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    83k GitHub starsUsed in 5 repos~1.3k tokens
    Research & ScienceAuto-check passed
  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed
  • Update V8 Version

    openinterpreter/openinterpreter

    Bumps the pinned v8 and rusty_v8 versions in Codex, validates the release-candidate path with the v8-canary check, and traces failures to upstream build changes.

    69k GitHub starsUsed in 2 repos~845 tokens
    DevOps & CloudAuto-check passed
  • Last30days

    mvanhorn/last30days-skill

    Research what people actually say about any topic in the last 30 days.

    64k GitHub stars~7.8k tokensUpdated today
    Research & ScienceAuto-check: notes

More from davepoon/buildwithclaude

All 245 skills in this repo
  • Qwen Vision

    davepoon/buildwithclaude

    A skill your agent uses when the user asks to "analyze video", "watch this video", "what happens in this video", "describe this clip", "review this footage", "classify these videos", "compare…

    3.6k GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • Hard Predict Future

    davepoon/buildwithclaude

    Activate this agent for any future-oriented question that requires deep quantitative analysis, historical precedents, and structured scenario planning.

    3.6k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • iOS Hig Design Guide

    davepoon/buildwithclaude

    Build, update, and apply iOS design specifications using Apple Human Interface Guidelines (HIG) source data.

    3.6k GitHub stars~735 tokensUpdated yesterday
    Auto-check passed
  • Video Downloader

    davepoon/buildwithclaude

    Download YouTube videos with customizable quality and format options.

    3.6k GitHub starsUsed in 1 repo~871 tokens
    Auto-check passed
  • Atlas Cloud Media

    davepoon/buildwithclaude

    Discover Atlas Cloud image and video models, inspect their live schemas, and submit one confirmed media generation request with bounded GET polling.

    3.6k GitHub stars~852 tokensUpdated yesterday
    Auto-check passed
  • Slack Gif Creator

    davepoon/buildwithclaude

    Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives.

    3.6k GitHub starsUsed in 12 repos~4.3k tokens
    Auto-check passed

Works with

Questions about Agent Analytics

What does Agent Analytics do?

Analytics your AI agent can actually use. An agent skill from davepoon/buildwithclaude. Agent Analytics is an agent skill from davepoon/buildwithclaude. Analytics your AI agent can actually use.

How do I install Agent Analytics in Claude Code?

Run `npx skills add davepoon/buildwithclaude --skill agent-analytics -a claude-code`. Or copy the skill folder (plugins/all-skills/skills/agent-analytics in davepoon/buildwithclaude) into .claude/skills/agent-analytics in your project. Claude Code loads it when a task matches its description.

How do I install Agent Analytics in Codex?

Run `npx skills add davepoon/buildwithclaude --skill agent-analytics -a codex`. Or copy the skill folder (plugins/all-skills/skills/agent-analytics in davepoon/buildwithclaude) into .agents/skills/agent-analytics in your project. Codex loads it when a task matches its description.

Can I use Agent Analytics 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 davepoon/buildwithclaude --skill agent-analytics -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agent-analytics, .gemini/skills/agent-analytics, .github/skills/agent-analytics and .opencode/skills/agent-analytics in your project.

What does Agent Analytics need to run?

Going by SKILL.md and its folder, Agent Analytics needs the command-line tools its instructions call (npx). Our summary lists: Node.js; A credential in AGENT_ANALYTICS_API_KEY.

Does Agent Analytics access the network?

SKILL.md names 3 domains. As links in the text: agentanalytics.sh, github.com and docs.agentanalytics.sh. This is read from the text; nothing was executed.

Is Agent Analytics 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 Agent Analytics use?

Agent Analytics 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 Agent Analytics use?

About 2k tokens (SKILL.md is roughly 8.1k 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 Agent Analytics?

Skills that share tags, products or a category with Agent Analytics: PR Babysitter (openinterpreter/openinterpreter, 69k stars), Diagnosing Superpowers Sessions (obra/superpowers, 296k stars), GitHub Deep Research (bytedance/deer-flow, 83k stars) and Greploop (onyx-dot-app/onyx, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agent Analytics?

davepoon (a GitHub user) maintains it in davepoon/buildwithclaude, which has 3,604 GitHub stars. The repository holds 245 skills in this directory. The repository was last updated on October 6, 2026.

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