spec-from-test

Convert Playwright or Cypress test files into demo-machine YAML specs.

6|1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/45ck/demo-machine --skill spec-from-test
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-from-test
Source: https://github.com/45ck/demo-machine/tree/main/.claude/skills/spec-from-test
Command: npx skills add https://github.com/45ck/demo-machine --skill spec-from-test

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert existing Playwright or Cypress tests into ready-to-run demo-machine YAML specs by reusing test coverage as polished demo scripts.

Core Features & Use Cases

  • Auto-convert test files to demo specs that can be executed by the demo-machine pipeline.
  • Reuse existing engineering test coverage to generate narrative steps for demos.
  • Supports common test structures from Playwright (.spec.ts, .test.ts) and Cypress (.cy.ts, .cy.js) projects.

Quick Start

Convert a test file into a demo-spec with one simple command.

Frequently Asked Questions about spec-from-test

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

FAQPage Schema
How do I convert Playwright or Cypress test files into demo specs?

To convert E2E tests into demo specs, this tool maps typical Playwright or Cypress test actions into demo-machine YAML specs, targeting common directories like tests/, e2e/, and cypress/ to reuse test coverage as demo scripts.

Can I generate demo scripts from existing e2e-testing coverage without external services?

Yes, you can generate demo scripts from existing e2e-testing coverage without external services. The conversion outputs a validated, ready-to-run YAML spec that integrates directly with the demo-machine workflow.

What's the best way to reuse Playwright .spec.ts files as demo scripts?

The best way to reuse Playwright .spec.ts files as demo scripts is converting them into demo-machine YAML specs. This process maps test actions to narrative steps, outputting validated specs for the demo pipeline.

Does the demo spec converter support both Cypress and Playwright test structures?

Yes, the demo spec converter supports both Cypress and Playwright test structures. It processes common file extensions like .spec.ts, .test.ts for Playwright, and .cy.ts, .cy.js for Cypress projects.

What limitations exist when mapping Cypress test actions to demo steps?

A key limitation when mapping Cypress test actions to demo steps is that it targets common test directories and typical actions. Complex or highly customized test logic may not map directly into the validated demo-machine YAML spec format.