[
  {
    "path": ".gitignore",
    "content": "*.swp\n"
  },
  {
    "path": "README.md",
    "content": "# Build your First Alexa Skill\n\n![Alexa Skill Terminology](https://cdn-images-1.medium.com/max/1200/1*E3155-o18xfC9hVHCriTbQ.png)\n\nEach Alexa skill is comprised of an “Invocation Name” which you can think of as your app name, a set of “Intents” and the phrases that map to each intent, and the software that can detect the intent and return an appropriate result.\n\n![Hello World Skill](https://cdn-images-1.medium.com/max/1200/1*BzP-MbBpdiNouIdHIL02Cg.png)\n\nThe skill we’re going to build is going to be an adaptation of the classic “Hello, World!” program.\n\n![Skill Steps](https://cdn-images-1.medium.com/max/1200/1*24YIKOd6a88tep2No3j2bA.png)\n\nBuilding your first skill will comprise of four steps. First we’re going to copy the “Hello, World!” code into Amazon Lambda, which will be responsible for running the code. Next we’re going to set up our skill in the Amazon Alexa Skills Developer Portal, and link our lambda account to that skill. Then we’re going to test using the Amazon service simulator and on an Alexa-enabled device. Lastly, we’ll walk through the steps of customizing your skill to your needs.\n\n![Alexa Skill Links](https://cdn-images-1.medium.com/max/1200/1*yfcCpuXFFdiZN35T5CLP5g.png)\n\nI put together a list of resources at [https://bit.ly/alexaskill](https://bit.ly/alexaskill), which is a public Instapaper folder I set up to make sharing the list of links easy. The slides will refer to each of these links. I’d recommend having this open in a tab so you can refer back to the links easily.\n\n## Step 1\n\n![Step 1: Lambda](https://cdn-images-1.medium.com/max/1200/1*xp0LoXq9DA80M2jQDZwkEA.png)\n\n![Step 1a: AWS Login](https://cdn-images-1.medium.com/max/1200/1*_FESNc05l3WFlfdrPwa3Cw.png)\n\n* Open the [AWS Lambda console](https://console.aws.amazon.com/lambda/home?region=us-east-1#/create?step=2)\n* Login or create an account with the same Amazon account that your Alexa device is linked to.\n\n![Step 1b: Amazon Lambda Function](https://cdn-images-1.medium.com/max/800/1*JVW4EmIx2xKnx6aYXqoJMg.png)\n\nEnter the name of your Lambda function. It’s not very important what the name is but it needs to be unique, you can just use “HelloWorld”. In the top right it should say “N. Virginia”. If that’s not the case please select “US-East (N. Virginia)” from the dropdown.\n\n![Step 1c: Copy Source Code](https://cdn-images-1.medium.com/max/800/1*TCQhZoLBJtDKdrpMBLxyUA.png)\n\nCopy the [Hello World application source code](https://github.com/Donohue/alexa/blob/master/src/index.js)\n\n![Step 1d: Paste Source Code](https://cdn-images-1.medium.com/max/1200/1*tVBGkuBWAk-wis-PAk07rg.png)\n\nBack in Lambda, you’re going to scroll down a bit and paste the code you copied from GitHub into the large text box under “Lambda function code”.\n\n![Step 1e: Set Execution Role](https://cdn-images-1.medium.com/max/1200/1*gXwTF9sNj_7L-45d8haE8A.png)\n\nScroll down a bit further to the “Lambda function handler and role” section. You’re going to want to set the role to “lambda\\_basic\\_execution”. It’s important to note that if this is your first time using Lambda, you’ll have to create the “lambda\\_basic\\_execution” role. You can do that by selecting the first option “* Basic Execution” and clicking the blue button on the next page. After you take that step, you should be able to select “lambda\\_basic\\_execution”.\n\n\n![Step 1d: Finish Creating Lambda Function](https://cdn-images-1.medium.com/max/1200/1*C36HxbtFT3lF9pFmv3JmDQ.png)\n\nOnce you’ve created the function, click on the “Event Sources” tab, then click the blue “Add event source” link, then select “Alexa Skills Kit” from the modal dropdown.\n\nPlease note if you’ve never signed up for the [Amazon Developer Portal](https://developer.amazon.com/edw/home.html#/skills/list), you’ll have to do that first before the “Alexa Skills Kit” will appear from the Event Sources dropdown. Please also make sure you use the same Amazon account as the one you’re using for AWS and your Echo.\n\n## Step 1 Done\n\n![Step 1 Done](https://cdn-images-1.medium.com/max/800/1*WXBkb3sWDvcw6ifyzvrItQ.gif)\n\nKeep the Amazon Lambda tab open though, we’ll need to come back to it!\n\n## Step 2\n\n![Step 2: Amazon Skills Portal](https://cdn-images-1.medium.com/max/800/1*fLVUygy4wQszmxRPS5PWHA.png)\n\n![Step 2a: Amazon Developer Login](https://cdn-images-1.medium.com/max/800/1*hGmDXfH3F2mKH6gIkCPZXA.png)\n\nOpen the [Amazon Developer Skills portal](https://developer.amazon.com/edw/home.html#/skills/list) and login with the same Amazon account that your Alexa device is linked with.\n\n![Step 2b: Navigate to Add New Skill](https://cdn-images-1.medium.com/max/800/1*MqUtpDDSsBTUuysjBier_A.png)\n\nClick the yellow “Get Started >” button under “Alexa Skills Kit”, then the yellow “Add a New Skill” button on the next page.\n\n![Step 2c: Name and Invocation Name](https://cdn-images-1.medium.com/max/800/1*7S6kAmf6jLZ7_8RaOZhs4Q.png)\n\nThe name of your Amazon Alexa skill must be unique for your account, and the invocation name is what you’ll use to activate the skill. “Alexa, tell <invocation name> to say Hello, World”. You can use “Hello World” if you’re lacking in creativity. Click the yellow “Next” button when you’re ready!\n\n![Step 2d: Interaction Model](https://cdn-images-1.medium.com/max/1200/1*iXt3o6KxIZ-wdrRfi4aHpA.png)\n\nHere is where we’re going to tell the skill which intents we support, and what type of words will trigger each intent. Get ready for some copy and pasting.\n\n![Step 2e: Copy Intent Schema](https://cdn-images-1.medium.com/max/800/1*Di-Zf3m1N0AWiHKXIpuqPg.png)\n\nOpen the [Hello World intent schema](https://github.com/Donohue/alexa/blob/master/speechAssets/IntentSchema.json) and copy all of the text in the box.\n\n![Step 2f: Paste Intent Schema](https://cdn-images-1.medium.com/max/1200/1*eBNZPWCWbasqh7H64sAGWQ.png)\n\nBack in the Amazon Skills portal, paste the intent schema you copied into the Intent Schema field.\n\n![Step 2g: Copy Sample Utterances](https://cdn-images-1.medium.com/max/800/1*ob0OlUPBdm8svBKhUFCdnA.png)\n\nOpen the [Hello World sample utterances](https://github.com/Donohue/alexa/blob/master/speechAssets/SampleUtterances.txt) and copy all of the text in the box.\n\n![Step 2h: Paste Sample Utterances](https://cdn-images-1.medium.com/max/1200/1*DFmTpNRTDYFaox3JqVGnQw.png)\n\nBack in the Amazon Skills portal, paste the sample utterances you copied into the Sample Utterances field. Click the yellow “Next” button after you’ve pasted the Sample Utterances.\n\n![Step 2i: Configuration](https://cdn-images-1.medium.com/max/1200/1*HKEFi0ievrGYBnoG0jBNMA.png)\n\nChange the radio button from “HTTPS” to “Lambda ARN” and select the “No” radio button under Account Linking. Now we’ll have to go and grab the Lambda Amazon Resource Name (ARN) from our Lambda tab. You still have that open, right?\n\n![Step 2j: Copy ARN](https://cdn-images-1.medium.com/max/800/1*yodxeQKrYjxxh26txdKtKg.png)\n\nThe ARN is on the top right of the Lambda function page. I have it selected in the image above. You’ll want to copy the selection as I have it above.\n\n![Step 2k: Paste ARN](https://cdn-images-1.medium.com/max/800/1*iJHo8qnBQb__hbQL0ro7lA.png)\n\nPaste the ARN into the text field, and press “Next”.\n\n## Step 2 Done\n\n![Step 2 Done](https://cdn-images-1.medium.com/max/800/1*npQAFDyVe3nr1v8x3MCW7A.gif)\n\n## Step 3\n\n![Step 3: Amazon Skill Test](https://cdn-images-1.medium.com/max/800/1*EQPNZwXv_8QO6_cvs3kiXA.png)\n\n![Step 3a: Service Simulator](https://cdn-images-1.medium.com/max/800/1*web80Yh6h15z3Psxa2VL3g.png)\n\nAfter you click “Next” on the “Configuration” tab, you should be on the “Test” tab. Under the “Service Simulator” portion you’ll be able to enter a sample utterance to trigger your skill. For the “Hello, World” example you should type “say hello world”, and on the right you should see the output from the Lambda function you created: “Hello, World!”\n\n![Step 3b: Test on Device](https://cdn-images-1.medium.com/max/800/1*XC3Eqp55G1VIXV5IAx3KBQ.png)\n\nIf you got the correct output using the Service Simulator, try it on the Amazon Echo. We were using “last name” as the invocation name in this presentation, but you should use the invocation name you set in step 2c.\n\n> Alexa, tell Hello World to say Hello World\n\n## Step 3 Done\n\n![Step 3 Done](https://cdn-images-1.medium.com/max/800/1*dsYNwEAIA57WXUbAMmYxLQ.gif)\n\nCongrats, you just created your first Alexa skill! 👏👏\n\n## Step 4: Customize\n\n![Step 4: Customize](https://cdn-images-1.medium.com/max/800/1*8tYf2HJDh9k-0F43bn-oLA.png)\n\n![Step 4a: Change Sample Utterances](https://cdn-images-1.medium.com/max/800/1*DWJUFWqGUSxekLk9xOf7BQ.png)\n\nGo back to “Interaction Model” tab in the Alexa Skill Developer portal, and edit the words on the right of “TestIntent” with the words you would like to say to Alexa. An example might be “who is the coolest person on earth”, and you’d say “Alexa, ask <invocation name> who is the coolest person on earth?” Next we’ll customize the output.\n\n![Step 4b: Change Lambda Output](https://cdn-images-1.medium.com/max/800/1*12QfN7P6jHdXpSBo0WEJ1w.png)\n\n* Go to the \"Code\" tab in Lambda.\n* Scroll to line 104 and replace Hello, World with your output.\n* Keep the quotes around your output.\n* Click \"Save\".\n* Test in Amazon Developer Portal.\n\n## Step 4 Done\n\n![Step 4 Done](https://cdn-images-1.medium.com/max/800/1*KdfqphskuVljnRPIgB3q8w.gif)\n\n\n"
  },
  {
    "path": "speechAssets/IntentSchema.json",
    "content": "{\r\n  \"intents\": [\r\n    {\r\n      \"intent\": \"TestIntent\"\r\n    },\r\n   {\r\n     \"intent\":\"AMAZON.PauseIntent\"\r\n   }, \r\n   {\r\n     \"intent\":\"AMAZON.ResumeIntent\"\r\n   }\r\n  ]\r\n}\r\n"
  },
  {
    "path": "speechAssets/SampleUtterances.txt",
    "content": "TestIntent hello world\r\nTestIntent say hello world\r\nTestIntent to say hello world\r\n\r\n"
  },
  {
    "path": "src/index.js",
    "content": "/**\n \n Copyright 2016 Brian Donohue.\n \n*/\n\n'use strict';\n\n// Route the incoming request based on type (LaunchRequest, IntentRequest,\n// etc.) The JSON body of the request is provided in the event parameter.\nexports.handler = function (event, context) {\n    try {\n        console.log(\"event.session.application.applicationId=\" + event.session.application.applicationId);\n\n        /**\n         * Uncomment this if statement and populate with your skill's application ID to\n         * prevent someone else from configuring a skill that sends requests to this function.\n         */\n\t\t \n//     if (event.session.application.applicationId !== \"amzn1.echo-sdk-ams.app.05aecccb3-1461-48fb-a008-822ddrt6b516\") {\n//         context.fail(\"Invalid Application ID\");\n//      }\n\n        if (event.session.new) {\n            onSessionStarted({requestId: event.request.requestId}, event.session);\n        }\n\n        if (event.request.type === \"LaunchRequest\") {\n            onLaunch(event.request,\n                event.session,\n                function callback(sessionAttributes, speechletResponse) {\n                    context.succeed(buildResponse(sessionAttributes, speechletResponse));\n                });\n        } else if (event.request.type === \"IntentRequest\") {\n            onIntent(event.request,\n                event.session,\n                function callback(sessionAttributes, speechletResponse) {\n                    context.succeed(buildResponse(sessionAttributes, speechletResponse));\n                });\n        } else if (event.request.type === \"SessionEndedRequest\") {\n            onSessionEnded(event.request, event.session);\n            context.succeed();\n        }\n    } catch (e) {\n        context.fail(\"Exception: \" + e);\n    }\n};\n\n/**\n * Called when the session starts.\n */\nfunction onSessionStarted(sessionStartedRequest, session) {\n    console.log(\"onSessionStarted requestId=\" + sessionStartedRequest.requestId\n        + \", sessionId=\" + session.sessionId);\n\n    // add any session init logic here\n}\n\n/**\n * Called when the user invokes the skill without specifying what they want.\n */\nfunction onLaunch(launchRequest, session, callback) {\n    console.log(\"onLaunch requestId=\" + launchRequest.requestId\n        + \", sessionId=\" + session.sessionId);\n\n    var cardTitle = \"Hello, World!\"\n    var speechOutput = \"You can tell Hello, World! to say Hello, World!\"\n    callback(session.attributes,\n        buildSpeechletResponse(cardTitle, speechOutput, \"\", true));\n}\n\n/**\n * Called when the user specifies an intent for this skill.\n */\nfunction onIntent(intentRequest, session, callback) {\n    console.log(\"onIntent requestId=\" + intentRequest.requestId\n        + \", sessionId=\" + session.sessionId);\n\n    var intent = intentRequest.intent,\n        intentName = intentRequest.intent.name;\n\n    // dispatch custom intents to handlers here\n    if (intentName == 'TestIntent') {\n        handleTestRequest(intent, session, callback);\n    }\n    else {\n        throw \"Invalid intent\";\n    }\n}\n\n/**\n * Called when the user ends the session.\n * Is not called when the skill returns shouldEndSession=true.\n */\nfunction onSessionEnded(sessionEndedRequest, session) {\n    console.log(\"onSessionEnded requestId=\" + sessionEndedRequest.requestId\n        + \", sessionId=\" + session.sessionId);\n\n    // Add any cleanup logic here\n}\n\nfunction handleTestRequest(intent, session, callback) {\n    callback(session.attributes,\n        buildSpeechletResponseWithoutCard(\"Hello, World!\", \"\", \"true\"));\n}\n\n// ------- Helper functions to build responses -------\n\nfunction buildSpeechletResponse(title, output, repromptText, shouldEndSession) {\n    return {\n        outputSpeech: {\n            type: \"PlainText\",\n            text: output\n        },\n        card: {\n            type: \"Simple\",\n            title: title,\n            content: output\n        },\n        reprompt: {\n            outputSpeech: {\n                type: \"PlainText\",\n                text: repromptText\n            }\n        },\n        shouldEndSession: shouldEndSession\n    };\n}\n\nfunction buildSpeechletResponseWithoutCard(output, repromptText, shouldEndSession) {\n    return {\n        outputSpeech: {\n            type: \"PlainText\",\n            text: output\n        },\n        reprompt: {\n            outputSpeech: {\n                type: \"PlainText\",\n                text: repromptText\n            }\n        },\n        shouldEndSession: shouldEndSession\n    };\n}\n\nfunction buildResponse(sessionAttributes, speechletResponse) {\n    return {\n        version: \"1.0\",\n        sessionAttributes: sessionAttributes,\n        response: speechletResponse\n    };\n}\n\n"
  }
]