Agent Skills

Install the Clics agent skill so Claude Code, Cursor, Antigravity, and OpenCode can query analytics via MCP or the CLI.

The Clics agent skill (clics) teaches AI coding agents how to work with your analytics workspace. It is the skill we ship today: one skill, covering MCP and CLI.

What it does

Agents that load the skill learn to:

Prefer MCP tools when the clics server is connected
Fall back to the CLI (@clicsdev/cli) for scripts, CI, or when MCP is unavailable
Authenticate correctly (CLICS_API_KEY for MCP, clics init for CLI)
Manage projects, goals, funnels, and sessions, and run query_stats / clics query

The skill file is published at skills/clics/SKILL.md. That file is the source of truth for agents. This page is the human install guide.

Install

Install from the public skills repo P-Essonam/clicsdev with the skills CLI:

npx skills add P-Essonam/clicsdev --skill clics

Global install (all projects):

npx skills add P-Essonam/clicsdev --skill clics -g -y

List skills in the repo without installing:

npx skills add P-Essonam/clicsdev --list

Skill source: skills/clics/SKILL.md.

Works with agents that support skills, including Claude Code, Cursor, Antigravity, and OpenCode.

After install

Connect MCP in your editor when you can (preferred for agents)
Or install and authenticate the CLI for terminal workflows
Ask something like: “List my Clics projects” or “Show visitors for the last 7 days”

MCP vs CLI (what the skill teaches)

Approach	When the agent uses it
MCP	`clics` MCP server is connected; no shell required
CLI	MCP unavailable, manual verification, scripts, or CI

Full CLI command reference: Skills + CLI.
MCP client setup: MCP.

What the skill covers

Short summary of the skill contents (details stay in SKILL.md):

Area	MCP tools	CLI
Projects	`list_projects`, `get_project`, `create_project`, `update_project`, `delete_project`	`clics projects …`
Goals	`list_goals`, `create_goal`, `update_goal`, `delete_goal`	`clics goals …`
Funnels	`list_funnels`, `get_funnel`, `create_funnel`, `update_funnel`, `delete_funnel`	`clics funnels …`
Sessions	`list_sessions`, `get_session`, `list_session_events`	`clics sessions …`
Stats	`query_stats`	`clics query …`

Example prompts

“Use Clics to list my projects”
“How many visitors did we get in the last 7 days?”
“Create a page goal for /pricing”
“Show conversion for my signup funnel”
“List recent sessions and show events for the longest visit”

Troubleshooting

Problem	Fix
Agent does not use Clics	Confirm the skill is installed and restart the agent
Agent shells out instead of MCP	Connect the MCP server in your client
CLI auth errors	Run `clics init --api-key "..."` (see Skills + CLI)