Skip to content

AI coding agents

AI coding agents like Cursor and Claude Code can manage your Supersimple data models, metrics, and explorations directly from your editor.

Install the Supersimple agent skill to give them the knowledge they need to use the CLI, write valid YAML, and keep your setup in sync.

Installation

Run this in your project root:

bash
bash -c 'U=https://storage.googleapis.com/cdn.supersimple.cloud/agent-skills; D=.claude/skills/supersimple; mkdir -p "$D/references" && for f in SKILL.md references/cli-reference.md references/data-model-yaml.md references/explorations-yaml.md; do curl -fsSL "$U/$f" -o "$D/$f"; done && echo "Installed to $D"'

This creates a .claude/skills/supersimple/ directory with the skill files. Claude Code will automatically pick up the skill and use it when relevant.

What the skill covers

  • Authentication — non-interactive login via CLI or environment variables
  • Data model management — creating, editing, validating, and importing YAML config
  • Database discovery — auto-generating models from your database schema
  • Explorations — exporting and editing dashboards as code
  • Dynamic enums — the skill guides the agent to set up load: distinct_values on categorical columns so the AI can filter accurately

Prerequisites

You'll need a Supersimple account with an API token. The skill will guide the agent through installing the CLI and authenticating if needed.