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, or Splunk migrations
controlling-costs	Analyze query patterns to find unused data and optimize Axiom costs

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:

1. org_id: Settings → Organization → Copy the org ID (or from URL: app.axiom.co/{org_id}/...)
2. token: Settings → Profile → Personal Access Tokens → Create token (use a Personal Access Token, not an API token, for full query access)

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

License

MIT License - see LICENSE