← Back to Skills Marketplace
1921
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install supalytics
Description
Query web analytics data using the Supalytics CLI. Use when the user wants to check pageviews, visitors, top pages, traffic sources, referrers, countries, revenue metrics, conversions, funnels, events, or realtime visitors.
Usage Guidance
This skill appears to do what it claims (wrap the Supalytics CLI), but take these precautions before installing or running it:
- Verify sources: bun.sh and @supalytics/cli come from public sources — confirm you trust bun.sh and the package registry before running curl | bash or global installs.
- Prefer manual installs: instead of piping a remote script to bash, manually review the bun installer or install Bun via your OS package manager if available. Consider installing the CLI in a per-project environment rather than globally.
- Confirm prerequisites: the SKILL.md requires Bun but the skill metadata only lists the supalytics binary; ensure Bun is installed and the supalytics binary is present. Examples use jq for JSON parsing — install jq if you need that behavior.
- OAuth handling: the doc asks the agent to capture and display the OAuth verification URL and poll for completion. Only proceed if you trust the agent to not exfiltrate the URL or tokens; prefer doing the browser authorization yourself.
- Scope and sandboxing: because the instruction set runs remote installers and global package installs, run it in a disposable/sandboxed environment (VM or container) if possible.
If the publisher can update the skill to explicitly declare Bun (and jq if intended) in required binaries and avoid recommending curl|bash, that would reduce risk and make the package more coherent.
Capability Analysis
Type: OpenClaw Skill
Name: supalytics
Version: 1.0.1
The skill is classified as suspicious primarily due to instructions in `SKILL.md` that require the AI agent to execute commands with elevated privileges. Specifically, it instructs the agent to run `sudo ln -sf ~/.bun/bin/bun /usr/local/bin/bun` and `sudo ln -sf ~/.bun/bin/supalytics /usr/local/bin/supalytics`. While the stated purpose is to make the CLI accessible, granting `sudo` access to an AI agent for system-wide path modification is a significant security risk, as it provides broad permissions. Additionally, the installation process involves `curl -fsSL https://bun.sh/install | bash`, which executes a remote script, posing a supply chain risk.
Capability Assessment
Purpose & Capability
The name/description (querying web analytics via the Supalytics CLI) line up with the runtime instructions and required binary (supalytics). The commands and examples are coherent with an analytics CLI.
Instruction Scope
SKILL.md instructs installing Bun and the @supalytics/cli, using supalytics commands, and handling OAuth device flow by capturing and presenting a verification URL. It does not instruct reading unrelated files or environment variables. Minor scope issues: the doc uses jq in examples but jq is not declared as a required binary; the instructions also run a global installer (bun add -g) which affects the host environment.
Install Mechanism
There is no formal install spec; the README tells the user to run curl -fsSL https://bun.sh/install | bash (a remote install script) and then bun add -g @supalytics/cli. While bun.sh is an official site, curl|bash patterns are higher risk because they execute remote code; global installs modify the host environment. The skill does not declare Bun as a required binary despite requiring it in the install steps.
Credentials
The skill requests no environment variables or secrets and relies on OAuth device flow for auth, which is proportionate. Note: OAuth requires the agent to capture and present verification URLs and poll for completion — ensure the agent will not leak that data. Also, examples reference jq but jq is not declared as required.
Persistence & Privilege
always:false and normal autonomous invocation. The skill does not request persistent system-wide configuration or elevated privileges in its metadata. The only notable persistence is the implicit global installation via bun add -g, which writes to the host environment.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install supalytics - After installation, invoke the skill by name or use
/supalytics - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Added troubleshooting steps for OpenClaw and daemon usage when Bun binaries are not in the system PATH.
- Updated troubleshooting table to mention symlink instructions if `command not found: supalytics`.
- Provided commands to symlink Bun and Supalytics CLI to `/usr/local/bin` for better compatibility with agent/daemon environments.
v1.0.0
Initial release of www.supalytics.co skill.
Supalytics is a simple, fast, web analytics tool that has revenue tracking and product analytics features. Helps you find the marketing channels that converts.
---
- Query web analytics data using the Supalytics CLI, including pageviews, visitors, top pages, traffic sources, referrers, countries, revenue, conversions, funnels, events, and realtime visitors.
- Provides detailed usage instructions, including installation (requires Bun), authentication (OAuth device flow), and command examples.
- Supports flexible querying with dimensions, metrics, filters, and output formats (human-readable tables or JSON).
- Includes site management commands and troubleshooting tips.
- Designed for use in agent contexts with specific support for OAuth flows in environments like OpenClaw.
Metadata
Frequently Asked Questions
What is Supalytics - Web Analytics?
Query web analytics data using the Supalytics CLI. Use when the user wants to check pageviews, visitors, top pages, traffic sources, referrers, countries, revenue metrics, conversions, funnels, events, or realtime visitors. It is an AI Agent Skill for Claude Code / OpenClaw, with 1921 downloads so far.
How do I install Supalytics - Web Analytics?
Run "/install supalytics" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Supalytics - Web Analytics free?
Yes, Supalytics - Web Analytics is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Supalytics - Web Analytics support?
Supalytics - Web Analytics is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Supalytics - Web Analytics?
It is built and maintained by yogesharc (@yogesharc); the current version is v1.0.1.
More Skills