Serverless Alexa Skills

homepage icon https://github.com/marcy-terui/serverless-alexa-skills
Follow @marcy-terui

Tracked

NPM Downloads Last Month
76
Issues
1
Stars
13
Forks
0
Watchers
13
Watch Star Fork Issue Download License NPM Build Status Coverage Status Contributors

Repo README Contents:

Serverless Alexa Skills Plugin

serverless Build Status

Description

Manage your Alexa Skills with Serverless Framework.

Requirements

Installation

serverless plugin install serverless-alexa-skills

or

npm install serverless-alexa-skills

Setup

First, you need to create a “Security Profile” and configure “Login with Amazon”.

Next, Check your Client ID, Client Secret and Vendor ID at Amazon developer console.

Configuration

serverless.yml

provider:
  name: aws
  runtime: nodejs6.10

plugins:
  - serverless-alexa-skills

custom:
  alexa:
    vendorId: ${env:YOUR_AMAZON_VENDOR_ID}
    clientId: ${env:YOUR_AMAZON_CLIENT_ID}
    clientSecret: ${env:YOUR_AMAZON_CLIENT_SECRET}
    skills:
      - id: ${env:YOUR_ALEXA_SKILL_ID}
        skillManifest:
          publishingInformation:
            locales:
              en-US:
                name: test2
          apis:
            custom: {}
          manifestVersion: '1.0'
        models:
          en-US:
            interactionModel:
              languageModel:
                invocationName: hello
                intents:
                  - name: AMAZON.CancelIntent
                    samples: []
                  - name: AMAZON.HelpIntent
                    samples: []
                  - name: AMAZON.StopIntent
                    samples: []
                  - name: HelloWorldIntent
                    samples:
                    - hello
                    - say hello
                    - hello world

Commands

alexa auth

Authenticate with Amazon OAuth2.

Caution

$ serverless alexa auth -h
Plugin: AlexaSkills
alexa auth .................... Authenticate with Amazon OAuth2

alexa create

Create an Alexa Skill.

$ serverless alexa create -h
Plugin: AlexaSkills
alexa create .................. Create an Alexa Skill
    --name / -n (required) ............. Name of the skill
    --locale / -l (required) ........... First locale of the skill (e.g. "ja-JP", "en-US")
    --type / -t (required) ............. Type of the skill (e.g. "custom", "smartHome", "video")

alexa delete

Delete an Alexa Skill.

$ serverless alexa delete -h
Plugin: AlexaSkills
alexa delete .................. Delete an Alexa Skill
    --id / -i (required) ............... Skill ID

alexa manifests

List your Alexa Skill Manifests.

$ serverless alexa manifests -h
Plugin: AlexaSkills
alexa manifests ............... List your Alexa Skill Manifests

alexa update

Update your Alexa Skill Manifests.

$ serverless alexa update -h
Plugin: AlexaSkills
alexa update .................. Update your Alexa Skill Manifests
    --dryRun / -d ...................... Dry run (Only output the diff)

alexa models

List your Alexa Interaction Models.

$ serverless alexa models -h
Plugin: AlexaSkills
alexa models .................. List your Alexa Interaction Models

alexa build

Update and buid your Alexa Interaction Models.

$ serverless alexa build -h
Plugin: AlexaSkills
alexa build ................... Update and buid your Alexa Interaction Models
    --dryRun / -d ...................... Dry run (Only output the diff)

Development

Pull requests are very welcome! Make sure your patches are well tested. Ideally create a topic branch for every separate change you make. For example:

  1. Fork the repo
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Authors

Created and maintained by Masashi Terui (marcy9114@gmail.com)

License

MIT License (see LICENSE)