open-testing-convert-gauge

Convert Gauge Markdown specs and concepts into a canonical representation.

13|1|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/AgenticTesting/OpenTestingAI --skill open-testing-convert-gauge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: open-testing-convert-gauge
Source: https://github.com/AgenticTesting/OpenTestingAI/tree/main/.opentesting-convert/skills/open-testing-convert-gauge
Command: npx skills add https://github.com/AgenticTesting/OpenTestingAI --skill open-testing-convert-gauge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts Gauge Markdown-based specs and concepts into a canonical, target-agnostic representation that can be emitted for multiple runner ecosystems, enabling end-to-end traceability and cross-target porting.

Core Features & Use Cases

  • Converts .spec and .cpt Gauge definitions into a unified canonical IR with steps, scenarios, data tables, and concept expansion.
  • Decodes step implementations from various languages and maps them to a common set of canonical actions.
  • Supports data-driven expansion, hooks, data stores, env references, and tag expressions across targets.

Quick Start

Run the converter on a Gauge project to generate target-ready canonical outputs from Markdown specs.

Frequently Asked Questions about open-testing-convert-gauge

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

FAQPage Schema
How do I convert Gauge Markdown specs to another testing framework?

To convert Gauge Markdown specs, this tool decodes .spec and .cpt files into a target-agnostic canonical representation. It maps steps, data tables, and concepts to a common format that can be emitted for multiple runner ecosystems.

Can I port Gauge step implementations across different programming languages?

Yes, you can port Gauge step implementations across languages. The converter decodes multi-language step implementations and resolves their bindings to canonical actions, enabling cross-target porting without losing traceability.

What is a target-agnostic canonical representation in spec conversion?

A target-agnostic canonical representation is an intermediate format that decouples Gauge Markdown specs from specific runners. It captures steps, scenarios, hooks, and data stores universally so they can be emitted to diverse target ecosystems.

Does the converter support Gauge data-driven scenarios and environment configurations?

Yes, the converter fully supports Gauge data-driven scenarios and environment configurations. It expands data tables, resolves environment references, and processes tag expressions to ensure accurate multi-target emission.

How do I handle unresolved constructs or missing steps when porting Gauge specs?

When porting Gauge specs, the converter surfaces extraction warnings for unresolved constructs. This mechanism identifies missing step implementations or unsupported syntax, allowing you to manually address gaps before final emission.

Are Gauge concept files included in the end-to-end spec conversion process?

Yes, Gauge concept files (.cpt) are included in the end-to-end spec conversion process. The tool expands concepts alongside .spec definitions, ensuring nested step sequences are fully mapped into the canonical representation.