Skip to content
An Alexa Skill Sample showing how to build a team lookup skill.
Branch: master
Clone or download
Latest commit b5935b6 Feb 22, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Adding standard files Mar 28, 2018
instructions Update Nov 19, 2018
lambda/custom Add space to phrases to avoid dot being voiced out Apr 11, 2018
models Adding standard files Mar 28, 2018
LICENSE.txt first commit Apr 24, 2017 Fix markdown heading render Jul 14, 2018 first commit Apr 24, 2017 first commit Apr 24, 2017
skill.json first commit Apr 24, 2017

Build An Alexa Team Lookup Skill

Voice User InterfaceLambda FunctionConnect VUI to CodeTestingCustomizationPublication

Get started

The idea behind this new sample app is pretty simple. Wouldn’t it be cool if there was a way you could look up the contact information for people by just asking Alexa? The sample data included with this template lets you search for Alexa Evangelists and Solutions Architects by city, and their first/last names.

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:

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


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.


Alexa, ask Alexa Team Lookup to find me someone in Boston.
	>> rob mccauley is a Solutions Architect on the Alexa Skills Team, based out of boston.

Alexa, start Alexa Team Lookup

Repository Contents

Setup w/ ASK CLI



  1. Clone the repository.

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

    $ cd skill-sample-nodejs-team-lookup
    $ ask init
  3. Install npm dependencies by navigating into the /lambda directory and running the npm command: npm install

    $ cd lambda/custom
    $ npm install


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:

    $ ask deploy


  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 "alexa, start alexa team lookup"
     ✓ Simulation created for simulation id: 4a7a9ed8-94b2-40c0-b3bd-fb63d9887fa7
    ◡ 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, or through your Amazon Mobile App and say :

    Alexa, start alexa team lookup


  1. ./skill.json

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

    Remember that many information is locale-specific and must be changed for each locale (en-GB and en-US)

    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.

  3. ./models/*.json

    Change the model definition 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


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!


You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.