← Back to Skills Marketplace
aiwithabidi

Amplitude

by aiwithabidi · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
717
Downloads
0
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install amplitude
Description
Amplitude product analytics — track events, analyze user behavior, run cohort analysis, manage user properties, and query funnel/retention data via the Ampli...
README (SKILL.md)

📉 Amplitude

Amplitude product analytics — track events, analyze user behavior, run cohort analysis, manage user properties, and query funnel/retention data via the Amplitude API.

Features

  • Event tracking — log user events with properties
  • User analytics — active users, sessions, engagement
  • Funnel analysis — conversion through event sequences
  • Retention analysis — user return rates over time
  • Cohort management — create and manage user cohorts
  • User properties — set and query user attributes
  • Revenue analytics — LTV, ARPU, revenue tracking
  • Segmentation — query by properties and events
  • Event segmentation — event counts and breakdowns
  • Dashboard export — export chart data

Requirements

Variable Required Description
AMPLITUDE_API_KEY API key/token for Amplitude
AMPLITUDE_SECRET_KEY Amplitude secret key for Export/Dashboard APIs

Quick Start

# Track an event
python3 {baseDir}/scripts/amplitude.py track '{"user_id":"user123","event_type":"purchase","event_properties":{"amount":29.99}}'
# Track batch events
python3 {baseDir}/scripts/amplitude.py track-batch events.json
# Set user properties
python3 {baseDir}/scripts/amplitude.py identify '{"user_id":"user123","user_properties":{"plan":"pro","company":"Acme"}}'
# Get active user counts
python3 {baseDir}/scripts/amplitude.py active-users --start 2026-01-01 --end 2026-02-01

Commands

track

Track an event.

python3 {baseDir}/scripts/amplitude.py track '{"user_id":"user123","event_type":"purchase","event_properties":{"amount":29.99}}'

track-batch

Track batch events.

python3 {baseDir}/scripts/amplitude.py track-batch events.json

identify

Set user properties.

python3 {baseDir}/scripts/amplitude.py identify '{"user_id":"user123","user_properties":{"plan":"pro","company":"Acme"}}'

active-users

Get active user counts.

python3 {baseDir}/scripts/amplitude.py active-users --start 2026-01-01 --end 2026-02-01

events

Get event data.

python3 {baseDir}/scripts/amplitude.py events --start 2026-01-01 --end 2026-02-01 --event purchase

funnel

Run funnel analysis.

python3 {baseDir}/scripts/amplitude.py funnel '{"events":[{"event_type":"page_view"},{"event_type":"signup"},{"event_type":"purchase"}]}' --start 2026-01-01 --end 2026-02-01

retention

Retention analysis.

python3 {baseDir}/scripts/amplitude.py retention --start 2026-01-01 --end 2026-02-01

cohorts

List cohorts.

python3 {baseDir}/scripts/amplitude.py cohorts

cohort-get

Get cohort details.

python3 {baseDir}/scripts/amplitude.py cohort-get abc123

revenue

Revenue analysis.

python3 {baseDir}/scripts/amplitude.py revenue --start 2026-01-01 --end 2026-02-01

user-search

Search for a user.

python3 {baseDir}/scripts/amplitude.py user-search "[email protected]"

user-activity

Get user activity.

python3 {baseDir}/scripts/amplitude.py user-activity user123

segments

Event segmentation query.

python3 {baseDir}/scripts/amplitude.py segments --event purchase --group-by platform --start 2026-01-01 --end 2026-02-01

Output Format

All commands output JSON by default. Add --human for readable formatted output.

# JSON (default, for programmatic use)
python3 {baseDir}/scripts/amplitude.py track --limit 5

# Human-readable
python3 {baseDir}/scripts/amplitude.py track --limit 5 --human

Script Reference

Script Description
{baseDir}/scripts/amplitude.py Main CLI — all Amplitude operations

Data Policy

This skill never stores data locally. All requests go directly to the Amplitude API and results are returned to stdout. Your data stays on Amplitude servers.

Credits


Built by M. Abidi | agxntsix.ai YouTube | GitHub Part of the AgxntSix Skill Suite for OpenClaw agents.

📅 Need help setting up OpenClaw for your business? Book a free consultation

Usage Guidance
This skill mostly looks like an Amplitude CLI, but there are two issues to consider before installing: (1) the manifest asks for AMPLITUDE_SECRET_KEY even though the shipped script never uses it — ask the author why that secret is required or remove it. (2) if AMPLITUDE_API_KEY isn't in the environment, the script will read a .env file from your workspace (~/.openclaw/workspace/.env or a path from WORKSPACE). That means the skill will access local files for credentials; ensure that .env doesn't contain unrelated secrets and prefer setting AMPLITUDE_API_KEY explicitly in the agent's secret store. If you require stronger assurance, request the author to remove the unused secret requirement, remove the .env fallback, or allow you to review an updated version that only uses declared credentials and documents why any local file reads are necessary.
Capability Analysis
Type: OpenClaw Skill Name: amplitude Version: 1.0.0 The skill's stated purpose of integrating with Amplitude API is benign. However, the `scripts/amplitude.py` file contains significant functional bugs where JSON payloads for commands like `track`, `track-batch`, and `identify` are not correctly parsed or passed to the API, rendering core functionalities non-operational. Additionally, the script exhibits a potential path injection vulnerability where `args.id` is directly interpolated into API URL paths without sanitization, which could be exploited for URL manipulation. While there is no evidence of intentional malice, these critical vulnerabilities and functional flaws make the skill suspicious.
Capability Assessment
Purpose & Capability
The skill claims to integrate with Amplitude and requires AMPLITUDE_API_KEY and AMPLITUDE_SECRET_KEY. The implementation only uses AMPLITUDE_API_KEY; AMPLITUDE_SECRET_KEY is declared but never read or used. Requesting a secret key that the code doesn't use is disproportionate and inconsistent with the stated purpose.
Instruction Scope
SKILL.md states 'never stores data locally' and that only the Amplitude API is contacted, but the CLI code will, if the AMPLITUDE_API_KEY env var is not set, try to read a .env file from a workspace path (WORKSPACE or ~/.openclaw/workspace/.env). That is file access outside the Amplitude API and may expose other local secrets if the .env contains them (the code only parses lines beginning with AMPLITUDE_API_KEY=, but reading local workspace files is scope creep relative to the documentation).
Install Mechanism
No install spec — instruction-only plus a Python script that relies on stdlib only. No external downloads or installers are declared, which is low-risk from an install-mechanism perspective.
Credentials
The skill requires two environment variables (AMPLITUDE_API_KEY and AMPLITUDE_SECRET_KEY). The code only reads AMPLITUDE_API_KEY (and will fall back to parsing a local .env for it). AMPLITUDE_SECRET_KEY is not used anywhere in the script, so requesting it is unnecessary and disproportionate. Additionally, the fallback to reading a workspace .env file can surface secrets stored there.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or global agent configuration, and does not write persistent files. It only reads a workspace .env file as a fallback and otherwise sends requests to amplitude.com.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install amplitude
  3. After installation, invoke the skill by name or use /amplitude
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the Amplitude product analytics skill. - Track events, analyze user behavior, run cohort and funnel analyses, manage user properties, and perform retention and revenue analysis via the Amplitude API. - Includes segmentation, event segmentation, dashboard export, and comprehensive CLI commands. - Requires only Python 3.10+ standard library (no external dependencies). - Secure: no data stored locally; all operations performed via direct API calls.
Metadata
Slug amplitude
Version 1.0.0
License
All-time Installs 3
Active Installs 3
Total Versions 1
Frequently Asked Questions

What is Amplitude?

Amplitude product analytics — track events, analyze user behavior, run cohort analysis, manage user properties, and query funnel/retention data via the Ampli... It is an AI Agent Skill for Claude Code / OpenClaw, with 717 downloads so far.

How do I install Amplitude?

Run "/install amplitude" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Amplitude free?

Yes, Amplitude is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Amplitude support?

Amplitude is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Amplitude?

It is built and maintained by aiwithabidi (@aiwithabidi); the current version is v1.0.0.

💬 Comments