Understand the Directory Structure of the Alexa Conversations Description Language
When you create an Alexa Conversations skill by using an Alexa Skills Kit Command-Line Interface (ASK CLI) quick-start template, the ASK CLI creates a skill directory. The directory includes the source code, interaction model, and Alexa Conversations artifacts for your skill. The Alexa Conversations artifacts use the Alexa Conversations Description Language (ACDL).
For a tutorial that walks you through creating a skill with ACDL by using the ASK CLI, see Tutorial: Create an Alexa Conversations Skill with ACDL.
Skill directory structure
The following table shows the directories contained within the skill directory.
<Skill Directory>/
├── .ask/
├── lambda/
└── skill-package/
│── build/
│ └── *.json files
│── conversations/
│ └── *.acdl files
│── interactionModels/
│ └── custom/
│ └── < locale name >.json
│ └── < another locale name >.json
│ └── ...
│── response
│ │── display/
│ │ │── < Folder for an APL document >
│ │ │ └── document.json
│ │ │── < Folder for another APL document >
│ │ │ └── document.json
│ │ └── < More folders for APL documents>
│ └── prompts/
│ │── < Folder for an APLA document >
│ │ └── document.json
│ │── < Folder for another APLA document >
│ │ └── document.json
│ └── < More folders for APL documents>
└── skill.json
Directory descriptions
The skill directory contains the following directories.
Path | Description |
---|---|
|
You can ignore this directory. |
|
This directory contains the dependency list ( |
|
This directory contains the Alexa Conversations Intermediate Representation (ACIR) files that the ACDL compiler generates during the skill compilation process. You typically don't edit files in this directory. |
|
This directory contains custom types, events, actions, and sample conversations, called dialogs, in ACDL file format. Dialogs are examples of conversations that you expect to occur between Alexa and the user throughout the course of your skill. |
|
This directory contains the For Alexa Conversations, your interaction model file must at least contain an invocation name and the |
|
This directory contains the visual content, if any, that Alexa displays to the user as APL files. ASK CLI quick-start templates, such as the Weather Bot template, don't have this directory if there's no visual content. Each response display file is named |
|
This directory contains the speech that Alexa says to the user as APLA files. For details about using APLA with Alexa Conversations, see Response Prompt Files for Alexa Conversations. For the APLA reference documentation, see APL for Audio Reference. Each response prompt file is named |
|
A file, called the skill manifest, contains the dialog management settings, endpoint settings, and other skill metadata information. All custom skills have a skill manifest. The skill manifest settings that are of specific interest to Alexa Conversations are the dialog management settings inside the For Alexa Conversation-specific details about the dialog management settings in the skill manifest, see Skill Manifest File for Alexa Conversations. For details about the skill manifest for all skills, see Skill Manifest Schema. |
Related topics
- Tutorial: Create an Alexa Conversations Skill with ACDL
- About Alexa Conversations Description Language
Last updated: Jan 03, 2022