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