Quickly Build A Multi Modal Quiz & Dictionary Alexa Skill

** This repository has been archived **

This repository is still available as a point-in-time reference, but no further updates or support will be prioritized.

Adding screens to your voice experience

This Alexa sample skill demonstrates the use of interactive render template directives through multi modal screen design, now in the V2 SDK. It provides an infrastructure that on one hand, provides lists to users to allow them to select from and get more information about topics (which are then rendered via body & list templates). On the other hand, it also provides users with a quiz that supports both touch and voice control. Most importantly, the skill has been designed in such a way that you can modify the core skill data to any category you like!

If this is your first time here, you're new to Alexa Skills Development, or you're looking for more detailed instructions, click the Get Started button below:

If you're slightly more advanced or familiar with SMAPI (Skill Management API), jump to the Setup w/ ASK CLI section below.

Be sure to take a look at the Additional Resources at the bottom of this page!

About

Note: The rest of this readme assumes you have your developer environment ready to go and that you have some familiarity with CLI (Command Line Interface) Tools, AWS, and the ASK Developer Portal. If not, click here for a more detailed walkthrough.

Usage

Alexa, open Berry Bash.
	>> Welcome to Berry Bash..

Alexa, ask Berry Bash to tell me about raspberries

Repository Contents

• /.ask - ASK CLI (Command Line Interface) Configuration
• /lambda/custom - Back-End Logic for the Alexa Skill hosted on AWS Lambda
• /models - Voice User Interface and Language Specific Interaction Models
• /instructions - Step-by-Step Instructions for Getting Started
• skill.json - Skill Manifest

Setup w/ ASK CLI

Pre-requisites

• Node.js (> v4.3)
• Register for an AWS Account
• Register for an Amazon Developer Account
• Install and Setup ASK CLI

Installation

1. Clone the repository

   $ git clone https://github.com/alexa/skill-sample-nodejs-berry-bash.git

2. Initiatialize the ASK CLI by Navigating into the repository and running npm command: ask init. Follow the prompts.

   $ cd skill-sample-nodejs-berry-bash
   $ ask init

3. Install npm dependencies by navigating into the /lambda/custom directory and running the npm command: npm install

   $ cd lambda/custom
   $ npm install

Deployment

ASK CLI will create the skill and the lambda function for you. The Lambda function will be created in us-east-1 (Northern Virginia) by default.

1. Deploy the skill and the lambda function in one step by running the following command (from the folder root):

   $ ask deploy

Testing

1. To test, you need to login to Alexa Developer Console, and enable the "Test" switch on your skill from the "Test" Tab.

2. Simulate verbal interaction with your skill through the command line using the following example:

    $ ask simulate -l en-US -t "open berry bash"
   
    ✓ Simulation created for simulation id: ***
   ◡ Waiting for simulation response{
     "status": "SUCCESSFUL",
     ...

3. Once the "Test" switch is enabled, your skill can be tested on devices associated with the developer account as well. Speak to Alexa from any enabled device, from your browser at echosim.io, or through your Amazon Mobile App and say:

   Alexa, open berry bash
   

Customization

1. ./skill.json

   Change the skill name, example phrase, icons, testing instructions etc ...

   See the Skill Manifest Documentation for more information.

2. ./lambda/custom/index.js

   Modify messages, and facts from the source code to customize the skill. Check out the Customise section for more info.

3. ./models/*.json

   Change the model defintion to replace the invocation name and the sample phrase for each intent. Repeat the operation for each locale you are planning to support.

Additional Resources

Community

• Amazon Developer Forums - Join the conversation!
• Hackster.io - See what others are building with Alexa.

Tutorials & Guides

• Voice Design Guide - A great resource for learning conversational and voice user interface design.
• CodeAcademy: Learn Alexa - Learn how to build an Alexa Skill from within your browser with this beginner friendly tutorial on CodeAcademy!

Documentation

• Official Alexa Skills Kit Node.js SDK - The Official Node.js SDK Documentation
• Official Alexa Skills Kit Documentation - Official Alexa Skills Kit Documentation