skill-testing-ml (maintained fork)

A YAML-based testing framework for Alexa skills. Write tests declaratively, run them with Jest.

Why this fork?

The original skill-testing-ml by Bespoken is discontinued and archived. It ships Jest 24 and several outdated dependencies with known vulnerabilities, making it incompatible with modern Node.js toolchains.

This fork maintains compatibility with current dependencies:

| Dependency | Original | This fork | |------------|----------|-----------| | jest | ^24.7.1 | ^29.7.0 | | jest-message-util | ^24.7.1 | ^29.7.0 | | lodash | ^4.17.11 | ^4.17.21 | | uuid | ^3.3.3 | ^11.0.0 | | chalk | ^2.4.2 | ^4.1.2 | | Node.js | >=12 | >=18 |

Removed unused dependencies: virtual-device-sdk, virtual-google-assistant.

Installation

npm install @planadecu/skill-testing-ml

This replaces bespoken-tools — you no longer need bst test. Use skill-tester directly.

Usage

Create a testing.json in your project root:

{
  "handler": "./src/index.js",
  "runInBand": true
}

Write tests in YAML:

---
- test: "Launch request"
- LaunchRequest:
  - response.outputSpeech.ssml: "Here's your fact"
  - response.card.type: "Simple"
  - response.card.title: "Space Facts"
  - response.card.content: "/.*/"

Run:

npx skill-tester

Features

• Multi-turn conversations
• Dialog Interface support
• AudioPlayer interface support
• Entity resolution
• Explicit intent and slot setting
• Wildcard support for non-regex expressions
• Support for setting address and permissions
• Explicit SessionEndedRequest
• Support for goto and flow control
• Support for testing DynamoDB
• Callbacks for filtering payloads programmatically

Documentation

• YAML test specification
• TestRunner & TestParser API
• Adding a custom invoker
• Development guide

Contributing

PRs are welcome. The goal is to keep this fork working with modern Node.js and up-to-date dependencies, not to add new features. If you find a compatibility issue, please open an issue or submit a fix.

License

ISC (see LICENSE)