apitestspec-scenario-runner

Execute API test specs from YAML, JSON, Excel, or CSV and report pass/fail results.

5|1|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/winhok/testkit --skill apitestspec-scenario-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apitestspec-scenario-runner
Source: https://github.com/winhok/testkit/tree/main/skills/apitestspec-scenario-runner
Command: npx skills add https://github.com/winhok/testkit --skill apitestspec-scenario-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, pyyaml, openpyxl, pytest, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Executes existing API test specs against the native framework and reports clear pass/fail results with attribution, enabling quick triage of failures without rewriting tests.

Core Features & Use Cases

  • Execute API test cases from YAML/JSON/CSV/Excel sources and obtain a consolidated pass/fail summary with failure attribution.
  • Resolve and honor project/config flows, environment variables, and setup/teardown steps, then produce structured results suitable for CI dashboards.
  • Output allure-results and a structured JSON results file for easy integration and reporting.

Quick Start

Run all configured API test cases by pointing the CLI at your project.yaml and optionally filter by tag.

Frequently Asked Questions about apitestspec-scenario-runner

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

FAQPage Schema
How do I run API test cases from YAML or JSON files and get pass/fail results?

You can run API test cases from YAML, JSON, CSV, or Excel files by pointing the CLI at your project.yaml. The runner executes the specs and generates a consolidated pass/fail summary with failure attribution.

Can I generate Allure results from existing API test specs for my CI pipeline?

Yes, you can generate Allure results from existing API test specs for your CI pipeline. The tool outputs allure-results and a structured JSON file suitable for easy integration and reporting on CI dashboards.

Does the API test runner support CSV and Excel sources alongside YAML and JSON?

Yes, the API test runner supports CSV and Excel sources alongside YAML and JSON. It loads test cases from all these formats, validates project loading, and executes step sequences to produce structured results.

What is the best way to triage API test failures without rewriting test scripts?

The best way to triage API test failures without rewriting scripts is to execute existing specs and report clear pass/fail results with attribution. This pinpoints exact flow discovery and step execution failures quickly.

Do I need pytest to execute API test specs and generate structured JSON reports?

Yes, you need pytest to execute API test specs and generate structured JSON reports. The framework relies on pytest alongside requests, pyyaml, and openpyxl to validate flows and produce CI-ready outputs.