katalyst-bdd-quickstart

Bootstrap a Katalyst BDD test project with stack-tests and npm/yarn commands.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/esimplicityinc/katalyst-domain-mapper --skill katalyst-bdd-quickstart
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: katalyst-bdd-quickstart
Source: https://github.com/esimplicityinc/katalyst-domain-mapper/tree/main/.opencode/skills/katalyst-bdd-quickstart
Command: npx skills add https://github.com/esimplicityinc/katalyst-domain-mapper --skill katalyst-bdd-quickstart

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Getting started with Katalyst BDD (@esimplicity/stack-tests) can be intimidating. This skill provides a guided path to install stack-tests, scaffold a new project, and begin writing and running your first feature.

Core Features & Use Cases

  • Step-by-step installation of @esimplicity/stack-tests and peer dependencies.
  • Clear project structure guidance for features, steps, and fixtures.
  • How to write your first feature file, register steps, and run tests.
  • Understanding the tag system across @api, @ui, @tui, and @hybrid for cross-layer testing.

Quick Start

From your project root, bootstrap the scaffold using the recommended CLI, then follow the prompts to create initial features and steps.

Frequently Asked Questions about katalyst-bdd-quickstart

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

FAQPage Schema
How do I scaffold a BDD testing project with stack-tests?

To scaffold a BDD testing project, you bootstrap the @esimplicity/stack-tests scaffold from your project root using the recommended CLI and follow the prompts to generate initial features and steps.

What is the tag system in Katalyst BDD stack-tests used for?

The Katalyst BDD tag system organizes tests across @api, @ui, @tui, and @hybrid layers, allowing you to categorize and selectively run cross-layer test suites within your feature files.

Do I need Node.js to set up a Katalyst BDD test project?

Yes, you need Node.js tooling installed and must be familiar with basic npm or yarn commands to install dependencies and scaffold the @esimplicity/stack-tests project.

How do I write and run my first feature file in Playwright BDD?

You write a feature file, register the corresponding steps, and run the tests using the stack-tests CLI commands. The scaffold provides the project structure for features, steps, and fixtures.

Can I run cross-layer tests across API and UI using stack-tests?

Yes, stack-tests supports cross-layer testing through its tag system, allowing you to execute @api, @ui, @tui, and @hybrid tagged scenarios to validate application layers simultaneously.

What's the best way to structure a TypeScript BDD test project?

The recommended structure separates features, steps, and fixtures into distinct directories. The stack-tests scaffold generates this layout automatically to keep your TypeScript BDD tests organized.