api-test-runner

Execute REST and GraphQL API test suites from a manifest file with JSON and JUnit XML output.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/graysurf/agent-kit --skill api-test-runner
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: api-test-runner
Source: https://github.com/graysurf/agent-kit/tree/main/skills/tools/testing/api-test-runner
Command: npx skills add https://github.com/graysurf/agent-kit --skill api-test-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill reduces CI boilerplate by providing a unified runner for API test suites, simplifying the process of testing REST and GraphQL endpoints.

Core Features & Use Cases

  • Unified Test Execution: Run diverse API test suites (REST + GraphQL) from a single manifest file.
  • CI Integration: Emits JSON and optional JUnit XML results, perfect for CI reporters.
  • Use Case: You need to ensure your API is functioning correctly across different environments. This Skill allows you to define a comprehensive test suite in a manifest file and run it consistently in your CI pipeline, generating reports for easy analysis.

Quick Start

Use the api-test-runner skill to run the 'smoke-demo' suite and output results to 'out/api-test-runner/results.json'.

Frequently Asked Questions about api-test-runner

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

FAQPage Schema
How do I run API tests for both REST and GraphQL from a single file?▼

Run API tests for both REST and GraphQL from a single manifest file using a unified test runner. This executes diverse test suites together, reducing CI boilerplate and simplifying endpoint validation across environments.

How do I generate JUnit XML reports for API tests in a CI pipeline?▼

Generate JUnit XML reports for API tests in a CI pipeline by executing a manifest-based test runner. The runner emits optional JUnit XML alongside JSON results, providing standard output formats that CI reporters consume for automated analysis.

What is a manifest file for API testing and when do I need one?▼

A manifest file for API testing is a single configuration file that defines and runs test suites for REST and GraphQL endpoints. You need one when you want to unify test execution across different environments and reduce CI configuration boilerplate.

Does a manifest-based API test runner work with my existing CI automation setup?▼

A manifest-based API test runner works with existing CI automation by outputting JSON and optional JUnit XML results. This compatibility allows seamless integration with standard CI reporters without requiring extensive pipeline modifications.

What is the best way to reduce boilerplate when automating REST and GraphQL test suites?▼

The best way to reduce boilerplate when automating REST and GraphQL test suites is to use a unified manifest runner. It consolidates test definitions into a single file and outputs JSON or JUnit XML, streamlining CI pipeline configuration and reporting.

Can I use the JSON output from API tests with other tools in my workflow?▼

You can use the JSON output from API tests with other tools in your workflow. The manifest runner provides a composable suite runner that emits JSON results, allowing downstream tools to parse and process test data for further analysis.