Steps To Create a Knowledge Skill

Follow the step-by-step process in the Alexa developer console to create, add data to, test, and distribute your knowledge skill. After you have distributed your skill, you can edit your skill to make changes.

For an explanation of knowledge skills, see Knowledge Skill Overview.

Create your knowledge skill

The following steps show you how to create a basic knowledge skill in the developer console.

To create a knowledge skill

  1. Sign in to the Alexa Skills Kit developer console.
  2. Click Create Skill.
  3. Enter a Skill Name. Then, as the Default language, select English (US).
  4. For Choose a model to add to your skill, select Knowledge.
  5. At the upper right, click Create skill.

Add data to your skill

To add data to your skill, you must first add one or more templates. Then, you download the template, add your data to the template in the correct format, and then upload the data to your skill.

To add your data to your skill

  1. If your knowledge skill is not already open, sign in to the Alexa Skills Kit developer console.
  2. In the skill list, choose your knowledge skill.
  3. Click Start or, on the left, click Step 1: Add templates.
  4. Select one or more templates, and then click Add templates.
    The templates that you added will appear on the left, under Step 2: Add data. For help selecting the right template for your skill, see Knowledge Skill Templates.
  5. In the left pane, click the template to which you want to add data, and then click Download template.
  6. Open the template CSV file that you downloaded, and remove the sample data.
  7. Add your own data and make sure that your data file fits the requirements listed in Knowledge Skill Templates.
  8. Save your CSV file and upload it on the template page. Either drag and drop the data file to the Upload Manager, or click Upload CSV and save and browse to find it on your computer.
  9. After your file uploads, you will see a non-exhaustive list of automatically generated sample queries. These are examples of questions that your skill can answer.

Test your skill

To see if your skill answers questions correctly, you can test your skill by using the developer console.

To test your skill

  1. Prepare a series of questions that you expect your users to ask Alexa. Use the sample queries and your own set of questions.
  2. If your knowledge skill is not already open, sign in to the Alexa Skills Kit developer console.
  3. In the skill list, choose your knowledge skill.
  4. At the top of the developer console, click Test.
  5. At the top left, next to Test is disabled for this skill, select Development.
  6. Enter the questions that you prepared, note the responses that Alexa provides, and adjust your data as needed.

For troubleshooting tips, see Troubleshooting Knowledge Skills. For general information about testing skills, see Test Your Skill.

Configure your skill for distribution

To distribute your skill, you must fill out the required distribution information. You can then distribute your skill through Alexa for Business or skill beta testing.

To configure your skill for distribution

  1. If your knowledge skill is not already open, sign in to the Alexa Skills Kit developer console.
  2. In the skill list, choose your knowledge skill.
  3. At the top of the developer console, click Distribution.
  4. Fill out the information on the Distribution page, as described in Define Skill Store Details and Availability. Note that you cannot submit a knowledge skill for public certification.
  5. After you enter the required information, you can set up your skill for distribution in one of the following ways:
    • Alexa for Business – Use this distribution method to make your skill available on Alexa devices within your organization. To set up distribution through Alexa for Business, go to your skill in the developer console, select the Distribution page, select Availability, select Alexa for Business Organizations, and then follow the prompts. For more information about creating a skill for Alexa for Business, see Understand Meetings Skills.
    • Skill beta testing – Use this distribution method to make your skill available to a specified set of users. You set this up in the Beta Testing section of the Distribution page, as described in Skill Beta Testing for Alexa Skills.
    • Personal Alexa devices – Other than enabling the skill for testing in the Test tab, you don't need to complete any other steps to query the skill on Alexa devices associated with your developer account.

Enable your skill

The way you enable your skill depends on how you plan to distribute it, as follows: