# Statsig Setup

> Configure an environment profile for the `datus statsig` plugin (Console API base URL, API key, version)

- Skill: `datus-ai/statsig-setup` (Agent Skill)
- Install (CLI): `npx skillmds@latest add datus-ai/statsig-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/datus-ai/statsig-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: datus-ai (https://skillmd.com/u/datus-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/datus-ai/statsig-setup

---


# Statsig Setup

Use this skill when `datus statsig` is installed but has no configured
environment, or when the user wants to add another environment.

## Config structure

Profiles live under `agent.plugins.statsig.<profile>` in the config file named
by the `## Plugins` section of the system prompt:

```yaml
agent:
  plugins:
    statsig:
      prod:
        default: true                       # mark exactly one profile as default
        api_key: ${STATSIG_CONSOLE_API_KEY} # required, SECRET — env var reference, never a literal
        # optional (defaults shown):
        api_base_url: https://statsigapi.net # Console API root (plugin appends /console/v1)
        api_version: "20240601"              # STATSIG-API-VERSION header
        timeout: 30                          # request timeout in seconds
```

## Steps

1. Ask the user for:
   - The **Console API key** — created at `console.statsig.com/api_keys`
     (Project Settings → API Keys → *Console* API Key, not a Server/Client SDK
     key). Have the user export it as an environment variable, e.g.
     `export STATSIG_CONSOLE_API_KEY=...`, and write `${STATSIG_CONSOLE_API_KEY}`
     into the YAML — **never a literal secret**.
   - `api_base_url` only if they are not on the default `https://statsigapi.net`
     (e.g. a dedicated/enterprise host). Otherwise omit it.
2. Write the profile into the config file named in the `## Plugins` preamble;
   mark the first profile `default: true`.
3. Verify with a cheap read-only call: `datus statsig metrics list --limit 5`
   (exercises connectivity + auth). A `401` means the key is wrong or is not a
   Console API key; exit `3` means `api_key` is missing from the profile.

If this environment cannot edit the config file (API / web deployment), tell
the user to edit `agent.yml` on the server instead.

## Notes

- Only `api_key` is a secret — it is the one field that must be a `${VAR}`
  reference. `api_base_url` / `api_version` are non-secret and are the only
  fields surfaced in the agent's system prompt.
- Mutating commands are rate-limited (~100/10s, ~900/15min per project).