# Installation

## 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.

![](/files/-MKk0gcKdohAl7hSOVRH)

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.

![](/files/-MKk1BYEywFyhxWhfRIu)

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

![](/files/-MKk1XPoYwXSKupeg7bS)

## 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:

![](/files/-MKkDU2dKNSIumhxu081)

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!

![](/files/-MKkGIr3XfQZ7oH3AU_w)

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**.

![](/files/-MKkGWIpl9nNJc_4-zpW)

Your skill is now correctly configured with CSML Studio!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.csml.dev/studio/channels/alexa/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
