Tianji Read-Only Data Queries
msgbyte/tianji
Answers questions about website traffic, monitors, surveys, events and billing from a Tianji instance using read-only GET calls checked against its live OpenAPI document.
Reads OpenPanel analytics through aai-cli: projects, raw event exports, aggregated insights for pages, referrers, devices and geography, and user profiles.
Install OpenPanel Analytics Reader
$ npx skills add aai-labs/agent-barn --skill aai-openpanel -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install aai-labs/agent-barn aai-openpanel --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/aai-labs/agent-barn.git skills-src && mkdir -p .claude/skills && cp -r skills-src/api/domains/agents/aai_cli_skills/bundled/skills/aai-openpanel .claude/skills/aai-openpanel && rm -rf skills-srcUse ~/.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/
Install the "aai-openpanel" agent skill from https://github.com/aai-labs/agent-barn/tree/main/api/domains/agents/aai_cli_skills/bundled/skills/aai-openpanel into .claude/skills/aai-openpanel/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aai-openpanel", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/aai-labs/agent-barn/tree/main/api/domains/agents/aai_cli_skills/bundled/skills/aai-openpanelType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add aai-labs/agent-barn --skill aai-openpanel -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install aai-labs/agent-barn aai-openpanel --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/aai-labs/agent-barn.git skills-src && mkdir -p .agents/skills && cp -r skills-src/api/domains/agents/aai_cli_skills/bundled/skills/aai-openpanel .agents/skills/aai-openpanel && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "aai-openpanel" agent skill from https://github.com/aai-labs/agent-barn/tree/main/api/domains/agents/aai_cli_skills/bundled/skills/aai-openpanel into .agents/skills/aai-openpanel/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aai-openpanel", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add aai-labs/agent-barn --skill aai-openpanel -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install aai-labs/agent-barn aai-openpanel --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/aai-labs/agent-barn.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/api/domains/agents/aai_cli_skills/bundled/skills/aai-openpanel .cursor/skills/aai-openpanel && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "aai-openpanel" agent skill from https://github.com/aai-labs/agent-barn/tree/main/api/domains/agents/aai_cli_skills/bundled/skills/aai-openpanel into .cursor/skills/aai-openpanel/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aai-openpanel", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/aai-labs/agent-barn.git --path api/domains/agents/aai_cli_skills/bundled/skills/aai-openpanel--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add aai-labs/agent-barn --skill aai-openpanel -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install aai-labs/agent-barn aai-openpanel --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/aai-labs/agent-barn.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/api/domains/agents/aai_cli_skills/bundled/skills/aai-openpanel .gemini/skills/aai-openpanel && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "aai-openpanel" agent skill from https://github.com/aai-labs/agent-barn/tree/main/api/domains/agents/aai_cli_skills/bundled/skills/aai-openpanel into .gemini/skills/aai-openpanel/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aai-openpanel", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install aai-labs/agent-barn aai-openpanelInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add aai-labs/agent-barn --skill aai-openpanel -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/aai-labs/agent-barn.git skills-src && mkdir -p .github/skills && cp -r skills-src/api/domains/agents/aai_cli_skills/bundled/skills/aai-openpanel .github/skills/aai-openpanel && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "aai-openpanel" agent skill from https://github.com/aai-labs/agent-barn/tree/main/api/domains/agents/aai_cli_skills/bundled/skills/aai-openpanel into .github/skills/aai-openpanel/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aai-openpanel", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add aai-labs/agent-barn --skill aai-openpanel -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install aai-labs/agent-barn aai-openpanel --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/aai-labs/agent-barn.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/api/domains/agents/aai_cli_skills/bundled/skills/aai-openpanel .opencode/skills/aai-openpanel && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "aai-openpanel" agent skill from https://github.com/aai-labs/agent-barn/tree/main/api/domains/agents/aai_cli_skills/bundled/skills/aai-openpanel into .opencode/skills/aai-openpanel/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aai-openpanel", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
aai-openpanel- GitHub stars
- 109
- Token cost
- ~469 tokens
- SKILL.md length
- 236 words
- Files
- 2 (incl. references)
- Skills in repo
- 12
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Reads OpenPanel analytics through aai-cli: projects, raw event exports, aggregated insights for pages, referrers, devices and geography, and user profiles.
- Pulling a project's page, referrer, device or geography breakdown for a date range
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Exporting raw events from an OpenPanel project
- Looking up user profiles recorded in OpenPanel
What it does
This is a read-only integration with OpenPanel that runs through the aai-cli openpanel command. It covers listing projects, exporting raw events, the aggregated insights commands and the profile commands. The agent is expected to pass the intended profile with --profile unless the default profile is already known.
Access depends on the client type behind the profile. Listing or fetching projects needs a root client, events export, insights and profiles need a read or root client, and a project's default write client fails every command with a 401 or 403 error. The pages, referrers, devices and geo breakdowns ignore limit and cursor and return every row unsorted, so a top-N answer means fetching all rows and sorting them yourself. Output is JSON on stdout, and errors are structured JSON on stderr.
When your agent uses it
- Pulling a project's page, referrer, device or geography breakdown for a date range
- Exporting raw events from an OpenPanel project
- Looking up user profiles recorded in OpenPanel
Example prompts
- “Show the most visited pages last week in our OpenPanel project.”
- “Export the raw events from the marketing site project for yesterday.”
- “List the user profiles that OpenPanel holds for the docs project.”
Requirements
- aai-cli
- An OpenPanel client with read or root access
What it can do on your machine
Read from SKILL.md and the folder at commit df5e0a7. 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
No URLs in SKILL.md.
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
OpenPanel Analytics Reader loads about 469 tokens when it runs, and up to ~7.4k if it reads all its reference files. Until then it costs about 39 tokens; SKILL.md has 236 words of instructions outside code blocks.
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 aai-labs/agent-barn at commit df5e0a7, republished under its Apache-2.0 licence (© aai-labs). 236 words, ~469 tokens.
Download SKILL.mdSave it as
.claude/skills/aai-openpanel/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- aai-openpanel
- description
- Use aai-cli to read OpenPanel projects, raw event exports, aggregated insights (metrics, pages, referrers, devices, geo), and user profiles.
aai-cli OpenPanel
Use this skill when working with OpenPanel analytics through aai-cli openpanel.
This is a read-only integration — there are no write endpoints (no identify/track calls, no project or client management). Always pass the intended profile with --profile unless the active default profile is already known.
OpenPanel clients are typed write, read, or root server-side, and this matters for which commands work with a given profile:
projects list/projects get(the Manage API) require arootclient.events export, allinsights *commands, andprofiles *commands require areadorrootclient.- A project's default
writeclient fails every command here with401/403.
insights * and profiles * commands need a project ID in the URL — pass --project-id or set profile.project_id to avoid repeating it. events export's --project-id is optional: omit it when the profile's client is already scoped to a single project.
insights pages/referrers/devices/geo accept --limit/--cursor but the provider ignores them — those four always return every breakdown row for the date range, unsorted. To answer a "top N" question, fetch all rows, then sort and slice client-side. Only events export really paginates, and a { "name": null, ... } breakdown row is the "no value for this dimension" bucket, not an error.
Successful output is JSON on stdout, wrapped in an _aai.pagination metadata block added by this CLI. Errors are structured JSON on stderr. See the command reference for command shapes, response notes, and examples captured from a live OpenPanel workspace.
© aai-labs, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 1 other file (references) in api/domains/agents/aai_cli_skills/bundled/skills/aai-openpanel of aai-labs/agent-barn.
- SKILL.md
- references/command-reference.md
Open the folder on GitHubat commit df5e0a7
Compare with similar skills
OpenPanel Analytics Reader 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| OpenPanel Analytics Reader this skillaai-labs/agent-barn | 109 | — | ~469 | Automated safety check: Pass | Apache-2.0 | |
| Tianji Read-Only Data Queriesmsgbyte/tianji | 3.1k | — | ~1.5k | Automated safety check: Pass | Apache-2.0 | |
| Opik Analytics Instrumentationcomet-ml/opik | 22k | — | ~4.4k | Automated safety check: Pass | Apache-2.0 | |
| PostHog CLI Queriesdebugtheworldbot/keyStats | 1.5k | — | ~1.2k | Automated safety check: Pass | MIT | |
| Retentioneering Contributingretentioneering/retentioneering-tools | 927 | — | ~1.8k | Automated safety check: Pass | Apache-2.0 | |
| Retentioneering Product Analyticsretentioneering/retentioneering-tools | 927 | — | ~1.6k | Automated safety check: Pass | Apache-2.0 |
Similar skills
Opik Analytics Instrumentation
comet-ml/opik
Shows how to add product analytics events to Opik's frontend, Java backend and Python SDK, all reporting through Segment to PostHog with an opik_ name prefix.
PostHog CLI Queries
debugtheworldbot/keyStats
Runs HogQL queries against this project's PostHog data from the terminal using posthog-cli, with bundled scripts for dashboard metadata the CLI itself has no command for.
Retentioneering Contributing
retentioneering/retentioneering-tools
Help the user turn their Retentioneering ideas, friction reports, bug findings, or feature needs into high-quality upstream contributions: from capturing and validating the idea, through minimal…
Retentioneering Product Analytics
retentioneering/retentioneering-tools
Analyze event logs, clickstreams, user paths, product funnels, retention, behavioral segments, transition graphs, step matrices, sequence patterns, and customer journeys using Retentioneering.
- Official
Feature Analytics Instrumentation Planner
mistralai/mistral-vibe
Plans which analytics events and properties a new feature needs, checks them against the existing event registry, and verifies them per environment.
More from aai-labs/agent-barn
All 12 skills in this repoaai-cli Microsoft 365
aai-labs/agent-barn
Guides work with Outlook, OneDrive, SharePoint, Teams, Excel, To Do and Planner through aai-cli's Microsoft Graph commands, starting from which service owns the data.
aai-cli Spreadsheet Editor
aai-labs/agent-barn
Uses aai-cli to create and edit local Excel and CSV files, manage sheet tabs and read, update or clear cell ranges.
aai-cli Google Drive
aai-labs/agent-barn
Finds, inspects, downloads and uploads Google Drive files from the command line with aai-cli, including exports of Docs, Sheets and Slides, and read-only sharing checks.
Aai Pipedrive
aai-labs/agent-barn
Use aai-cli to manage Pipedrive leads, persons, organizations, deals, labels, activities, notes, file attachments, field definitions, users, pipelines and stages, deal flow/stage history, and synced…
Aai Bitbucket
aai-labs/agent-barn
Use aai-cli to inspect and manage Bitbucket repositories, pull requests, branches, commits, source files, comments, and pipelines.
Aai Confluence
aai-labs/agent-barn
Use aai-cli to inspect and manage Confluence spaces, pages, comments, attachments, and page moves.
Related
Categories
Questions about OpenPanel Analytics Reader
What does OpenPanel Analytics Reader do?
Reads OpenPanel analytics through aai-cli: projects, raw event exports, aggregated insights for pages, referrers, devices and geography, and user profiles. This is a read-only integration with OpenPanel that runs through the aai-cli openpanel command. It covers listing projects, exporting raw events, the aggregated insights commands and the profile commands.
When should I use OpenPanel Analytics Reader?
OpenPanel Analytics Reader fits situations like: pulling a project's page, referrer, device or geography breakdown for a date range; exporting raw events from an OpenPanel project; looking up user profiles recorded in OpenPanel.
How do I install OpenPanel Analytics Reader in Claude Code?
Run `npx skills add aai-labs/agent-barn --skill aai-openpanel -a claude-code`. Or copy the skill folder (api/domains/agents/aai_cli_skills/bundled/skills/aai-openpanel in aai-labs/agent-barn) into .claude/skills/aai-openpanel in your project. Claude Code loads it when a task matches its description.
How do I install OpenPanel Analytics Reader in Codex?
Run `npx skills add aai-labs/agent-barn --skill aai-openpanel -a codex`. Or copy the skill folder (api/domains/agents/aai_cli_skills/bundled/skills/aai-openpanel in aai-labs/agent-barn) into .agents/skills/aai-openpanel in your project. Codex loads it when a task matches its description.
Can I use OpenPanel Analytics Reader 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 aai-labs/agent-barn --skill aai-openpanel -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/aai-openpanel, .gemini/skills/aai-openpanel, .github/skills/aai-openpanel and .opencode/skills/aai-openpanel in your project.
What does OpenPanel Analytics Reader need to run?
SKILL.md names no scripts, command-line tools or credentials: OpenPanel Analytics Reader is instructions for the agent only. Our summary lists: aai-cli; An OpenPanel client with read or root access.
Does OpenPanel Analytics Reader access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is OpenPanel Analytics Reader 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 OpenPanel Analytics Reader use?
OpenPanel Analytics Reader is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does OpenPanel Analytics Reader use?
About 469 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7k tokens, read only when the agent opens those files.
What are the alternatives to OpenPanel Analytics Reader?
Skills that share tags, products or a category with OpenPanel Analytics Reader: Tianji Read-Only Data Queries (msgbyte/tianji, 3.1k stars), Opik Analytics Instrumentation (comet-ml/opik, 22k stars), PostHog CLI Queries (debugtheworldbot/keyStats, 1.5k stars) and Retentioneering Contributing (retentioneering/retentioneering-tools, 927 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains OpenPanel Analytics Reader?
aai-labs (a GitHub organization) maintains it in aai-labs/agent-barn, which has 109 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 9, 2026.
Source: aai-labs/agent-barn on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.