mirror of https://github.com/axiomhq/skills.git synced 2026-09-19 00:55:01 +08:00

Files

T

Heinz N. Gies d9d4f157f0 feat(metrics-chart): add chart skill for metrics v3 query results

Render Axiom metrics query results (application/vnd.metrics.v3+json) as
multi-series line charts.

- Zero-dependency Python stdlib Unicode/braille renderer (default, works in
  any terminal/transcript/CI log)
- Optional gnuplot backend for PNG/SVG/sixel; font/line weight scale with the
  canvas; non-ASCII (e.g. em dash) emitted as real UTF-8
- Series reduction: collapse near-overlapping lines, cap at top-N by peak, and
  report dropped counts in the legend
- Local-time x-axis (--tz override), null points drawn as gaps, group_keys
  legends (e.g. "200 | GET"), units from response metadata
- auto format: inline image on image-capable terminals; a PNG file plus an
  explicit "display this file" instruction when piped (AI agent harness);
  ASCII in a plain terminal or when gnuplot is absent
- 35 unit tests (parser pinned to service/query/src/server/tests.rs goldens)
- Registered in the repo README and given a per-skill README

Co-authored-by: Claude <noreply@anthropic.com>

2026-07-06 11:47:24 +02:00

3.0 KiB

Raw Permalink Blame History

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)
axiom-alerting	Unified monitor + notifier management for Axiom alerting via the v2 API
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
metrics-chart	Render metrics query results (`application/vnd.metrics.v3+json`) as line charts; zero-dependency ASCII by default, optional gnuplot PNG/SVG/sixel (pairs with query-metrics)
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)

MCP Server

.mcp.json configures the hosted Axiom MCP Server at https://mcp.axiom.co/mcp for agent clients that install plugins from a manifest. See the MCP setup docs.

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

3.0 KiB Raw Permalink Blame History