Skip to content

edgedelta/agent-skills

Repository files navigation

Edge Delta Agent Skills

Edge Delta skills for AI agents (Claude Code, Cursor, Copilot and other SKILL.md-compatible tools), built on the edx CLI.

See it in action

Ask your agent a root-cause question and the skills drive the investigation. Here is what it looks like in Claude Code — surging error patterns found, onset quantified, verdict delivered (ed-investigate):

root-cause investigation in Claude Code

And tracing a fleet regression back to the offending pipeline config change, with the rollback command ready (ed-pipelines):

config-change root cause in Claude Code

The edx outputs in these clips are from real investigations against a live org, replayed with scripted timing to keep the clips short (see demo/). Re-record with vhs demo/<name>.tape — no credentials appear on screen.

Skills

Skill Description
ed-edx Primary CLI - all edx commands, auth, setup
ed-logs Search logs with CQL, log volume graphs
ed-patterns Log patterns, anomaly and sentiment analysis
ed-metrics Discover and aggregate metrics
ed-traces Distributed traces and the service map
ed-events Events: anomalies, monitor alerts, K8s events
ed-monitors Create, manage and resolve monitors
ed-pipelines Fleet management, config changes, deployments, live capture
ed-pipeline-tuning Improve data quality: parse, structure, enrich, mask, roll up to metrics/patterns
ed-investigate Cross-signal incident investigation workflow
ed-ai-teammate AI Teammate connectors and activity

Setup edx

brew install edgedelta/tap/edx          # or: go install github.com/edgedelta/edx@latest

# Token auth (good for CI):
edx auth login --token <api-token> --org-id <org-id>
# Or OAuth (browser login; org is read from the token):
edx auth login --oauth

edx auth status

API tokens are created in the Edge Delta web app under Admin → API Tokens. Environment variables ED_API_TOKEN, ED_ORG_ID and ED_ENV (prod, staging or local) override the config file - useful in CI.

Install Skills

npx skills add edgedelta/agent-skills \
  --skill ed-edx \
  --skill ed-logs \
  --skill ed-patterns \
  --skill ed-metrics \
  --skill ed-traces \
  --skill ed-monitors \
  --skill ed-pipelines \
  --skill ed-pipeline-tuning \
  --skill ed-events \
  --skill ed-investigate \
  --skill ed-ai-teammate \
  --full-depth -y

Or copy the skill directories you need into your agent's skills folder (e.g. .claude/skills/).

Conventions Used Across Skills

  • Discovery before queries: edx facets keys / edx facets options to find field names and values before writing CQL.
  • Time ranges: --lookback 1h (Go durations) or --from/--to (ISO 8601).
  • Default output is JSON; --output table --columns ... for summaries.
  • Destructive operations (deploy, delete) require --yes when non-interactive.

About

Edge Delta skills for AI agents, built on the edx CLI

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors