- name
SKILL.md
El archivo de la skill permanece en el repositorio del publicador.
Pega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add davepoon/buildwithclaude --skill agent-analytics -a cursor -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add davepoon/buildwithclaude --skill agent-analytics -a claude-code -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add davepoon/buildwithclaude --skill agent-analytics -a codex -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add davepoon/buildwithclaude --skill agent-analytics -a grok -yEnvía el mensaje copiado en un chat de Grok Bot. El Bot obtiene este SKILL.md de GitHub y lo añade a las skills que comparten todos tus Bots.
Install this skill: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/agent-analyticsDel publicador
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
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.
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:
# 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).
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.
If tracking is already set up, check what events and property keys are already in use so you match the naming:
npx @agent-analytics/cli properties-received PROJECT_NAME
Use onclick handlers on the elements that matter:
<a href="..." onclick="window.aa?.track('EVENT_NAME', {id: 'ELEMENT_ID'})">
Pick the ones that apply. Most sites need 2-4:
snake_case: hero_get_started not heroGetStartedid property identifies WHICH element: short, descriptivesection_action: hero_signup, pricing_pro, nav_dashboardExperiments let you test which variant of a page element converts better. The full lifecycle is API-driven — no dashboard UI needed.
npx @agent-analytics/cli experiments create my-site \
--name signup_cta --variants control,new_cta --goal signup
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.
<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.
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.
After adding tracking, verify it works:
# Click around, then check:
npx @agent-analytics/cli events PROJECT_NAME
# Events appear within seconds.
All commands use npx @agent-analytics/cli:
# 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
For any "how is X doing" question, always call insights first — it's the single most useful endpoint.
Track custom events via window.aa?.track():
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'});
live for a real-time TUI)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
---name: agent-analyticsdescription: Analytics your AI agent can actually use. Track, analyze, run A/B experiments, and optimize across all your…---# plugins/all-skills/skills/agent-analytics/SKILL.mdResumen general
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.
Preguntas frecuentes
Descarga plugins/all-skills/skills/agent-analytics/SKILL.md desde el publicador, o copia la ruta y abre el repositorio. PlugMCP lista la skill y no aloja el archivo.
El publicador lo mantiene en https://github.com/davepoon/buildwithclaude.
Claude, Cursor, Codex y Grok Build pueden leer un SKILL.md que añadas desde el repositorio del publicador. Grok Bot lo instala cuando envías en un chat el enlace a la carpeta de la skill en GitHub.