Alexa for Business
Administration Guide

Private Skills

In addition to public Alexa skills, developers can use the Alexa Skills Kit to publish skills privately to Alexa for Business organizations without the need to certify or have the skill available with all other Alexa skills. For more information, see Create and Publish Private Skills.

To build private skills

  1. Set up the Skills Management API (SMAPI) SDK environment. For more information, see Alexa Skill Management API.

  2. Download the skill manifest of the development stage skill you intend to publish as a private skill to your AWS account.

    $ ask api get-skill -s {skill_id} > skill_file_name.json

  3. Add the following line in the publishingInformation section of your skill manifest file that you outputted with the command:

    "distributionMode": "PRIVATE"

  4. To upload the updated skill manifest, update the skill with the modified manifest using update-skill. The following is an example of an update skill command:

    $ ask api update-skill -s {skill_id} -f skill.json

  5. Submit your skill using the following command. This step may take up to two hours to complete. After completion, the skill is available in the live stage.

    ask api submit -s <skill_id>

  6. After the skill is available in the live stage, distribute it to one or more Alexa for Business organizations. Use the ARN of the AWS account.

    ask api add-private-distribution-account -s <skillId> --stage live --account-id <id>


    --skill-id, -s is required. This is the skill ID for the skill to get and must be in the following format: amzn1.ask.skill.12345678-1234-1234-123456789123

    --stage is required. This is the stage for the skill. The live stage is currently the only supported stage.

    --account-id is required. This is the ARN of the AWS account where you want to make the skill available. Example: arn:aws:iam::123456789012:root

    You can remove the AWS account ARN from the private distribution account list at any time, which revokes access to the private skill from an account, by using the following command:

    ask api delete-private-distribution-account <-s|--skill-id <skillId>> --stage live <--account-id <id>>

    To list all the accounts to which the skill has been privately distributed, or that have access to the private skill, run the following command:

    ask api list-private-distribution-accounts <-s|--skill-id <skillId>> --stage live

To manage private skills

  1. Open the Alexa for Business console at

  2. Choose Skills, Private skills.

  3. In the list, select the skill that was published to your account and choose Review.

  4. To enable the skill for your Alexa for Business organization, choose Enable.

  5. To enable the skill for your Alexa devices, choose Enabled skills, select the check box next to the skill that you added, and choose Add to skill group.

  6. To make the skill available for end users to discover and enable, choose Private skills and select the Available to users checkbox.