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.