concurrent-api-test-from-gherkin

Generate concurrent API tests from Gherkin feature files with vitest.

3|1|Updated Jun 28, 2021
One-click install
npx skills add https://github.com/VilledeMontreal/concurrent-api-tests --skill concurrent-api-test-from-gherkin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: concurrent-api-test-from-gherkin
Source: https://github.com/VilledeMontreal/concurrent-api-tests/tree/main/template/.claude/skills/concurrent-api-test-from-gherkin
Command: npx skills add https://github.com/VilledeMontreal/concurrent-api-tests --skill concurrent-api-test-from-gherkin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Transform Gherkin feature files into reliable, concurrent API tests that validate API behavior in parallel and help catch integration issues early.

Core Features & Use Cases

  • Automatic translation of Gherkin scenarios into vitest-based tests using the concurrent-api-tests framework.
  • Enforces isolated data partitions per test using the data-partitions.yaml specification to ensure zero cross-test state.
  • Generates a structured test suite mapping features, rules, and examples to describe/it blocks and it.each where applicable for scenario outlines.

Quick Start

Use the Gherkin-driven approach to generate parallel API tests from a feature file, an OpenAPI spec, and a data-partitions.yaml to bootstrap the test suite.

Frequently Asked Questions about concurrent-api-test-from-gherkin

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

FAQPage Schema
How do I convert Gherkin feature files into parallel API tests?▼

You can convert Gherkin feature files into parallel API tests by mapping scenarios to vitest tests using the @villedemontreal/concurrent-api-tests library, ensuring each test runs concurrently with isolated data partitions defined in a data-partitions.yaml file.

Why do my concurrent API tests fail due to shared state between scenarios?▼

Concurrent API tests fail from shared state when data partitions are not isolated. This skill enforces per-endpoint data partitioning using a data-partitions.yaml specification to ensure zero cross-test state and reliable parallel execution.

Do I need an OpenAPI specification to generate vitest tests from Gherkin?▼

Yes, an OpenAPI specification is required alongside Gherkin feature files and a data-partitions.yaml to generate vitest-based concurrent API tests that validate endpoints with proper arrange-act-assert structure.

What is the best way to run isolated API tests in parallel using vitest?▼

The best way to run isolated API tests in parallel is using stateless test design with per-endpoint data partitioning, mapping Gherkin scenario outlines to it.each blocks to ensure concurrent execution without cross-test dependencies.

Can I use Gherkin scenario outlines to generate data-driven API tests?▼

Yes, Gherkin scenario outlines are mapped to it.each blocks in vitest, generating data-driven concurrent API tests that validate multiple examples against isolated data partitions defined in your data-partitions.yaml.

How does Gherkin scenario mapping work for concurrent API test generation?▼

Gherkin scenario mapping translates feature files, rules, and examples into structured vitest describe and it blocks, applying arrange-act-assert patterns to generate concurrent API tests with isolated data partitions.