smoke-gateway

Run end-to-end smoke tests on AI Gateway models and configurations.

21|3|Updated May 26, 2026
One-click install
npx skills add https://github.com/AlphaBitCore/nexus-gateway --skill smoke-gateway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: smoke-gateway
Source: https://github.com/AlphaBitCore/nexus-gateway/tree/main/.claude/skills/smoke-gateway
Command: npx skills add https://github.com/AlphaBitCore/nexus-gateway --skill smoke-gateway

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates end-to-end validation of the AI Gateway and Control Plane by running a comprehensive smoke test across all models and configurations.

Core Features & Use Cases

  • Full-surface smoke testing across all catalog models, including non-stream, SSE, and embeddings.
  • Automatic routing rule management and per-rule isolation for different environments.
  • Traffic and metrics validation through cross-checks of traffic_event DB rows and Prometheus counters, with auto-fix loops when failures are detected.
  • Self-healing loop that rebuilds, restarts the gateway, and reruns tests until green.
  • Cross-model coverage across P3, P3E embeddings, and routing scenarios for regression validation.

Quick Start

Provide a virtual key and optional routing to execute the full smoke suite against the AI Gateway.

Frequently Asked Questions about smoke-gateway

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run end-to-end smoke tests for an AI Gateway?

You can run AI Gateway smoke tests by providing a virtual key and optional routing flags to execute a full test suite across all catalog models. The harness outputs a Markdown report detailing the validation results.

Does AI Gateway smoke testing support non-stream, SSE, and embedding workflows?

Yes, AI Gateway smoke testing supports non-stream, SSE, and embedding workflows. The test harness validates full-surface coverage across all catalog models, ensuring routing rules and traffic metrics function correctly across these specific request types.

How does automated smoke testing handle routing rule validation and metric cross-checks?

Automated smoke testing validates routing rules through per-rule isolation and automatic management. It cross-checks traffic_event database rows against Prometheus counters, triggering auto-fix loops when metric validation failures are detected.

What happens when a smoke test detects a failure in the AI Gateway Control Plane?

When a smoke test detects a failure in the AI Gateway Control Plane, a self-healing loop initiates. This loop automatically rebuilds, restarts the gateway, and reruns the tests until a green status is achieved, ensuring reliability without manual intervention.

Can I use this smoke test harness for regression validation across different environments?

You can use this smoke test harness for regression validation across development, test, and production-like environments. It provides cross-model coverage across P3, P3E embeddings, and routing scenarios to verify system stability.

What inputs are required to execute a full smoke suite against the AI Gateway?

Executing a full smoke suite against the AI Gateway requires inputs such as a virtual key, routing flags, model selections, and reporting parameters. These inputs allow the test harness to configure and validate the necessary workflows.