Archive

When creating a custom Alexa skill, you will need to provide an invocation name that users will use to invoke and interact with your skill. The invocation name does not need to be the same as your skill’s name but it must meet certain criteria to ensure a positive user experience. The invocation name you provide should also easily identify your skill’s capabilities, be memorable and also be accurately recognized by Alexa herself.

Invoking Your Custom Skill

Your service gets called when customers use your invocation name, such as “Alexa, ask dungeon dice for a d20.” In this example, users invoke the custom Alexa skill by using the Invocation Name ‘dungeon dice’ along with a supported phrase for requesting the service.

You can change your invocation name at any time while developing a skill. You cannot change the invocation name after a skill is certified and published.

It is also important to think about how the rest of the invocation phrase will sound when using your invocation name. Remember, there are three ways in which users will always invoke your skill. A good invocation name will make sure it works well in all of these contexts:

Invoking the skill with a particular request. For example, “Alexa, Ask Daily Horoscopes for Gemini.”

Invoking the skill without a particular request, using a defined phrase such as “open” or “start.” For example, “Alexa, open Daily Horoscopes.”

Invoking the skill using just the invocation name and nothing else: “Alexa, Daily Horoscopes.”

The invocation name must not contain any of the Alexa skill launch phrases and connecting words. Launch phrase examples include “launch,” “ask,” “tell,” “load,” and “begin.” Connecting word examples include “to,” “from,” “by,” “if,” “and,” “whether.” See Understanding How Users Invoke Custom Skills for a complete list of skill launch phrases and connecting words.

The invocation name must not contain the wake words “Alexa,” “Amazon,” “Echo,” or the words “skill” or “app.”

The invocation name must contain only lower-case alphabetic characters, spaces between words, possessive apostrophes (for example, “sam’s science trivia”), or periods used in abbreviations (for example, “a. b. c.”). Other characters like numbers must be spelled out. For example, “twenty one.” The name must be easy to pronounce correctly and be phonetically distinct to avoid being misinterpreted as other similar sounding words.

The invocation name must not create confusion with existing Alexa features. If your invocation name overlaps with common Alexa commands, users may get confused by Alexa's response and not enable your skill. For example, if your invocation name is too similar to the built-in "weather" command, Alexa may sometimes respond with your skill and sometimes respond with the built-in weather feature, providing an inconsistent user experience.

The following recommendations are not required for certification, but will provide your users with a better experience and are highly recommended:

The skill invocation name should be specific to the functionality of the skill, unless the invocation name is unique to your brand or intellectual property (for example, “uber,” “dominos”). One way to achieve relevance is to qualify the invocation name with something that describes the skill’s functionality or something relevant to your company or developer name. For example, “boston transit,” “cricket trivia,” “math tutor,” “magic eight ball,” “baby stats,” “tim’s jokes.”

The invocation name should also fit smoothly with at least one of the Alexa skill launch phrases (for example, “launch,” “ask,” “tell,” “load,” “begin”) to allow customers to naturally invoke the skill.

Finally, plan on spending some time testing your invocation name once you have an initial version of your service up and running. When testing with an Alexa-enabled device, you can see how Alexa interpreted your invocation name by reviewing the history in the Amazon Alexa App (in the app, navigate to Settings and then History).

For more guidance on creating a Custom Skill for Alexa, check out the following additional assets: