> ## Documentation Index
> Fetch the complete documentation index at: https://axiom.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Build dashboards skill

> This page explains how to use the Build dashboards skill to give AI coding agents the ability to design and build Axiom dashboards.

The Build dashboards skill turns AI agents into dashboard design experts:

* **Design methodology**: Decision-first dashboard design with overview-to-drilldown structure
* **Chart types**: Complete reference for statistic, time series, table, pie, log stream, heatmap, and more
* **APL patterns**: Golden signal queries, cardinality guardrails, and time-based aggregations
* **Smart filters**: Interactive filtering with cascading dropdowns
* **API helpers**: Scripts for creating, updating, and validating dashboards via the Axiom API
* **Templates**: Pre-built dashboard templates for common use cases

## Prerequisites

* [Create an Axiom account](https://app.axiom.co/register).
* [Create a dataset in Axiom](/reference/datasets#create-dataset) where you send your data.
* [Create an API token in Axiom](/reference/tokens) with permissions to ingest data to the dataset you have created.

## Install Axiom Skills

Install all Axiom skills at once for Claude Code, Cursor, and other Claude-compatible agents:

```bash theme={null}
npx skills add axiomhq/skills
```

### Configure Axiom credentials

All Axiom Skills share the same credential configuration. Create a configuration file at `~/.axiom.toml`:

```toml ~/.axiom.toml theme={null}
[deployments.dev]
url = "https://api.axiom.co"
token = "API_TOKEN"
org_id = "ORGANIZATION_ID"
edge_url = "AXIOM_DOMAIN"
```

<Info>
  Replace `API_TOKEN` with the Axiom API token you have generated. For added security, store the API token in an environment variable.

  Replace `ORGANIZATION_ID` with your organization ID. For more information, see [Determine organization ID](/reference/tokens#determine-organization-id).

  Replace `AXIOM_DOMAIN` with the base domain of your edge deployment. For more information, see [Edge deployments](/reference/edge-deployments).

  For token creation and scoping guidance, see [Token hygiene for AI agents](/console/intelligence/ai-agents-overview#token-hygiene-for-ai-agents).
</Info>

## Use Build dashboards skill

The Build dashboards skill activates automatically when you ask your AI agent to:

* Create or design dashboards
* Migrate Splunk dashboards to Axiom
* Configure chart types and options
* Build smart filters for interactive filtering

Example prompts:

* "Create a service health dashboard for the API"
* "Build a dashboard with error rate, latency percentiles, and traffic trends"
* "Add a smart filter dropdown for filtering by environment"
* "Migrate this Splunk dashboard to Axiom"

## Dashboard templates

The Build dashboards skill includes pre-built templates:

| Template                             | Use case                                             |
| ------------------------------------ | ---------------------------------------------------- |
| `service-overview.json`              | Single-service on-call dashboard with heatmap        |
| `service-overview-with-filters.json` | Single-service dashboard with smart filter dropdowns |
| `api-health.json`                    | HTTP API with traffic, errors, and latency           |
| `blank.json`                         | Minimal dashboard skeleton for custom dashboards     |
