Agent Skills

query-metrics

Installation
CLI
npx skills add https://github.com/axiomhq/skills --skill query-metrics

Install this skill with the CLI and start using the SKILL.md workflow in your workspace.

Last updated 4/24/2026

Axiom Skills

Agent skills for working with Axiom. Skills are folders of instructions, scripts, and resources that coding agents load dynamically to improve performance on specialized tasks.

Available Skills

Skill Description
sre Hypothesis-driven SRE investigation with Axiom
spl-to-apl Translate Splunk SPL queries to Axiom APL
building-dashboards Design and build Axiom dashboards from intent, templates, Splunk migrations, and metrics/MPL chart payloads (works with query-metrics)
controlling-costs Analyze query patterns to find unused data and optimize Axiom costs
query-metrics Run metrics queries against Axiom MetricsDB and discover available metrics, tags, and values
writing-evals Scaffold evaluation suites for the Axiom AI SDK

Requirements

  • jq - JSON processor (brew install jq or apt install jq)
  • curl - HTTP client (usually pre-installed)
  • bc - Calculator, needed by controlling-costs (brew install bc or apt install bc)

Installation

npx skills add axiomhq/skills

This installs all skills. Skills have dependencies on each other (e.g., controlling-costs depends on sre and building-dashboards), so installing all is recommended.

After installing, run the setup script to configure Axiom access:

~/.config/agents/skills/sre/scripts/setup

Configuration

Most skills require access to Axiom. Create ~/.axiom.toml with your deployment(s):

[deployments.prod]
url = "https://api.axiom.co"
token = "xaat-your-api-token"
org_id = "your-org-id"

[deployments.staging]
url = "https://api.axiom.co"
token = "xaat-your-staging-token"
org_id = "your-staging-org-id"

To get these values:

  • org_id - The organization ID. Get it from Settings → Organization.
  • token - Use an advanced API token with minimal privileges.

The deployment name (e.g., prod, staging) is passed to scripts: scripts/axiom-query prod "..."

License

MIT License - see LICENSE