Alexa Skills Toolkit for Visual Studio Code
Alexa Skills Toolkit for Visual Studio Code is an extension that makes it easier for you to create, test, and deploy Alexa skills. It provides a dedicated workspace for Alexa Skills in VS Code and provides features for managing and previewing APL documents along with the ability to test and debug your skills in VS Code with local debugging.
See the getting started documentation
- To create and deploy Alexa-hosted skills, download Git and install it. We recommend the latest version of
git to have a seamless experience.
- Install and configure VSCode Python extension, if you plan to develop skills using python.
ASK CLI is no longer a requirement for the extension and the commands are no longer available in the VSCode Command Palette. Please install and use the
ASK CLI directly.
Sign in to your Amazon Developer account
Create a skill
Create and preview APL documents
Setup local debugging
Deploy and build skill
- Set up skill project
- Quickly set up an Alexa skill project by creating a skill or downloading an existing skill or opening a local skill. Any skill that follows the ASK CLI v2 skill structure is supported. Use the Skill Management tab under the extension, to try these out.
- Once opened, your skill project will appear under the Skills pane in the extension sidebar.
Note: Currently, Alexa Skills Toolkit only supports creation and deployment of Alexa-hosted skills.
- Build or Download Interaction Model
- Edit the Interaction Model JSON under
Skill Package folder of your skill project.
- Alternatively, download the updated Interaction Model JSON from developer console using the Download option under Skills pane -> YourAwesomeSkill -> Interaction model.
Note: Currently, only saved and built interaction models can be downloaded from developer console.
Build or Download Skill Manifest
- Edit the Skill Manifest JSON under
Skill Package folder of your skill project.
- Alternatively, download the updated Skill Manifest JSON from developer console using the Download option under Skills pane -> YourAwesomeSkill -> Skill manifest.
Create, Download & Preview APL Documents
- Create new APL documents using the Create option under Skills pane -> YourAwesomeSkill -> Alexa Presentation Language (APL).
- Download saved APL documents in the APL Authoring tool, using Download option under Skills pane -> YourAwesomeSkill -> Alexa Presentation Language (APL).
- Preview APL documents in
Skill Package, using Preview option under Skills pane -> YourAwesomeSkill -> Alexa Presentation Language (APL).
- Optionally, change the viewport of the preview to a different device, using Change viewport profile option under Skills pane -> YourAwesomeSkill -> Alexa Presentation Language (APL).
Test & Debug Skills Locally
- Add default Node/Python debug configurations in your skill's
launch.json debug configuration file, install dependencies (
ask-sdk-local-debug) and start a local debug session. More information can be found on the getting started documentation
Note: If you are using any existing profiles, we recommend you to recreate them again from the Skill Management tab -> hamburger (
...) menu -> Profile Manager view, so that the profile will contain all LWA scopes needed for local debugging.
- Deploy your skill
- Deploy all committed changes in your skill, using the Deploy & Build option under Skills pane -> YourAwesomeSkill.
Note: Currently, Alexa Skills Toolkit only supports deployment of Alexa-hosted skills, using Git. Commit any changes you wish to deploy to your skill's
master branch. You can use VS Code's built-in Git support or any Git client.
- Quickly jump to Alexa Skills Kit docs using the links under Documentation pane.
- Create or delete profiles using Profile Manager under the hamburger menu (
...) of Skill Management pane.
- Quickly jump between multiple developer profiles using the
ASK Profile status bar item.
and many more ...
We would like to hear about your bugs, feature requests, questions or quick feedback.
The Alexa Skill Toolkit for VSCode extension is distributed under the Apache License, Version 2.0. Any marks/logos displayed as part of the extension GUI are not licensed under an open source license, but instead subject to Amazon’s Trademark Guidelines, available here.
Data & Telemetry
The Alexa Skill Toolkit for VSCode extension collects usage data and sends it to Amazon to help improve our products and services. This extension respects the
Ask: Telemetry Enabled /
ask.telemetryEnabled setting under the extension settings.