> For the complete documentation index, see [llms.txt](https://docs.csml.dev/studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.csml.dev/studio/channels/alexa/installation.md).

# Installation

How to configure an Amazon Alexa skill with CSML Studio

## Step 1: Initial setup in the Alexa Console

To create an Amazon Alexa skill, you will first need to create a free developer account on <https://developer.amazon.com/alexa>, then visit the [Alexa Skills Kit (ASK) console](https://developer.amazon.com/alexa/console) and click on Create Skill.

![](https://2862118938-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6OZMoZlXP9VSWYMW_T%2F-MKjwsgPqXTJZDXFmwuO%2F-MKk0gcKdohAl7hSOVRH%2Fimage.png?alt=media\&token=1b19c093-fc44-4db4-a585-d0aff4b5c36b)

In the next section, give your skill a name and select the default language. This can be changed later! Under **Choose a model to add to your skill**, select **Custom**, and under **Choose a method to host your skill's backend resources**, select **Provision your own**, then click on **Create Skill** at the top.

![](https://2862118938-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6OZMoZlXP9VSWYMW_T%2F-MKjwsgPqXTJZDXFmwuO%2F-MKk1BYEywFyhxWhfRIu%2Fimage.png?alt=media\&token=c45fcf49-3d7a-4b0b-bbf0-288e0ce94072)

In the next screen, select **Start from scratch**. Alexa will then build your skill.

![](https://2862118938-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6OZMoZlXP9VSWYMW_T%2F-MKjwsgPqXTJZDXFmwuO%2F-MKk1XPoYwXSKupeg7bS%2Fimage.png?alt=media\&token=11ac362a-eca1-403d-b31d-7cf451d6d27e)

## Step 2: Connecting your skill with CSML Studio

Once the skill is built, you will need to connect it with CSML Studio. This step is actually very easy. First, find [the list of all your skills in the Alexa Skills Kit console](https://developer.amazon.com/alexa/console/ask) and copy the Skill ID of your skill:

![](https://2862118938-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6OZMoZlXP9VSWYMW_T%2F-MKk1oiqRinSI6xxpB9F%2F-MKkDU2dKNSIumhxu081%2Fimage.png?alt=media\&token=3cf2a671-4044-4710-9ae0-354044390c34)

Then, in CSML Studio, create a new Alexa channel for your bot under **Channels > Amazon Alexa** and set the name and ID of your skill. You will also need to copy the **HTTPS Endpoint URL** to configure the Skill in the ASK console later. You can then save for now!

![](https://2862118938-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6OZMoZlXP9VSWYMW_T%2F-MKk1oiqRinSI6xxpB9F%2F-MKkGIr3XfQZ7oH3AU_w%2Fimage.png?alt=media\&token=bd3bdd2a-f62f-4d07-87a2-09c1001aa781)

To finalize the configuration, in the ASK Console, visit your skill's **Build tab > Endpoint**. By default, AWS Lambda ARN is selected: select **HTTPS** instead and under **Default Region**, paste your HTTPS Endpoint URL from CSML Studio and select the SSL Certificate option "*My development endpoint is a sub-domain of a domain that has a wildcard certificate from a certificate authority*", then click on **Save Endpoints**.

![](https://2862118938-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6OZMoZlXP9VSWYMW_T%2F-MKk1oiqRinSI6xxpB9F%2F-MKkGWIpl9nNJc_4-zpW%2Fimage.png?alt=media\&token=517fab82-918f-4fd1-8f0d-a76e0d0a1734)

Your skill is now correctly configured with CSML Studio!