Alexa Skill Test provides a live server for local testing of Alexa Skills written in Node.js. Right now, testing skills usually involves going through the Amazon Alexa Developer Portal. This project makes testing much easier.
- Node/npm
- An Amazon Alexa Skill written in Node.js
It's recommended to install Alexa Skill Test as a global npm package:
npm install -g alexa-skill-test
After install, the alexa-skill-test command will be available to you.
Alexa Skill Test works off one command:
alexa-skill-test [--path] [--interaction-model]
--path let's you optionally specify a relative path to your skill. --interaction-model let's you optionally specify a relative path to your interaction model.
Within your terminal, change directory to your valid Amazon skill. Your skill will need a package.json and a main script file. Run the following command:
alexa-skill-test
This starts up a local testing server using your Alexa skill. If you specify a relative path to an interaction model using --interaction-model, the app will prefill your skill intents for you.
In your browser, navigate to http://localhost:3000. You should see a simple UI for sending test requests to your skill.
Note:
In the skill(s) you're testing, you should set your appId like so:
if ('undefined' === typeof process.env.DEBUG) {
alexa.appId = '...';
}Setting an appId while debugging will cause Lambda to throw an error since there will be a mismatch. Alexa Skill Test will automatically set the DEBUG environmental variable.
MIT