skills.rest
ForgePlan
ForgePlanOFFICIAL
Explore all skills by this author →
WebsiteGitHub

scenario-writer

Convert business use cases and invariants into executable Gherkin scenarios with Mermaid diagrams.

3|Updated Apr 3, 2026
Search Tags:#testing#mermaid#scenarios#use case#gherkin
One-click install
npx skills add https://github.com/ForgePlan/marketplace --skill scenario-writer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: scenario-writer
Source: https://github.com/ForgePlan/marketplace/tree/main/plugins/forgeplan-brownfield-pack/skills/scenario-writer
Command: npx skills add https://github.com/ForgePlan/marketplace --skill scenario-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires use-cases, invariants, gherkin-parser, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill converts verified use cases and invariants into executable Gherkin scenarios with visual Mermaid sequence diagrams, streamlining test specification and documentation creation.

Core Features & Use Cases

  • Use Case Conversion: Converts business use cases and invariants into executable Gherkin scenarios.
  • Mermaid Diagrams: Generates Mermaid sequence diagrams for visualizing scenarios.
  • Scenario Generation: Automatically generates scenarios based on use cases and invariants.
  • Scenario Validation: Validates Gherkin syntax for generated scenarios.

Quick Start

Run the scenario-writer skill with a use case file 'use-case.txt'.

Frequently Asked Questions about scenario-writer

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

FAQPage Schema
How do I generate Gherkin scenarios from use cases?▼

To generate Gherkin scenarios from use cases, provide the use case and invariant artifacts as input to automate scenario creation. The tool converts business requirements into executable Gherkin syntax while validating the output.

Can I create Mermaid sequence diagrams from Gherkin scenarios?▼

Yes, you can create Mermaid sequence diagrams from Gherkin scenarios by converting business use cases and invariants. The generated diagrams visually map the executable scenarios for streamlined test documentation.

What is the best way to automate test specification from business invariants?▼

The best way to automate test specification from business invariants is to process verified invariant artifacts alongside use cases. This automatically produces executable Gherkin scenarios with syntax validation and visual Mermaid sequence diagrams.

Do I need use case artifacts to validate Gherkin syntax for generated scenarios?▼

Yes, you need use case and invariant artifacts to validate Gherkin syntax for generated scenarios. The conversion requires these input files to automatically generate and validate the executable test scenarios.

Why use automated scenario generation for use case testing?▼

Automated scenario generation for use case testing streamlines test specification by converting business requirements into validated Gherkin syntax. It eliminates manual syntax errors and automatically produces visual Mermaid sequence diagrams for documentation.

Related Skills

Explore More Software Engineering Skills→
vuthuonghai-stevevuthuonghai-steve
1

activity-diagram-design-analyst

Analyze and design UML Activity Diagrams in Mermaid syntax with Clean Architecture principles.

Community
Advanced
ahgraberahgraber
5

mermaid

Generate and locally render Mermaid diagrams for chatbot flows.

Community
Intermediate
Z1-TestZ1-Test

gherkin-authoring

Create executable behavior specifications using Gherkin Given/When/Then syntax.

Official
Intermediate
SensLiaoSensLiao

i2r-acceptance-mode

Convert functional requirements JSON into Gherkin scenarios and prose acceptance criteria.

Community
Intermediate