Tips for Creating a Great Flash Briefing Skill
A customer's Flash Briefing is populated with Flash Briefing skills. Flash Briefing skills can contain multiple feeds, and a feed can contain up to five items that are read or played to the customer. A good skill consists of the right mixture of feeds and feed items.
This document gives some tips to create Flash Briefing skills that provide a delightful customer experience.
Update your Flash Briefing frequently; at least daily. Customers listen to their Flash Briefing as part of their daily routine, and every feed they turn on will play during their briefing. To make sure that customers hear new content every day, you should update your feeds at least daily. If content is repeated day after day, customers may disable your skill.
Make your content a key part of a customer's daily routine. Provide content that customers look forward to consuming, particularly as a part of their morning or afternoon routines. This could include news, weather, sports, comedy, movie and/or television reviews and more.
Make your content short. Flash Briefing is designed to provide short pieces of content to the customer as they go about their daily routines. We suggest that feeds should be no more than a few minutes long for an audio clip, about 1-2 minutes for text-to-speech (TTS).
Split your content into feeds around topics or themes. If you or your company creates multiple RSS feeds or audio clips organized around different topics or themes, you should consider organizing these RSS feeds or clips as separate feeds under a single skill. You can do this on the Developer Portal when creating a skill.
Separate your feed into items. If you have several headlines or short summaries that you want to provide in your feed, break them into feed items. Each item is separated by an earcon (audible icon) sound, so customers can hear the separation between items.
Remove stale feed items. Flash Briefing will automatically play the five most recent items contained in the RSS or JSON file for a feed. If you do not want these five items played every time a customer requests their flash briefing, then you must remove older items from the RSS or JSON file.
Choose short, meaningful titles for items in a feed. Choose titles that are a few words to a short sentence, but that also provide context for the content. For example, “Alexa Guru Creates a Custom Skill in a Single Day”.
List feeds in the skill description. When you create the long description for your skill in the Developer Portal, make sure you list the feeds that are included in the skill, as well as specifying the default feed. This helps make sure that your feeds display to a customer when they search the Skill Store. List the included feeds at the end of the description. For example:
Avoid advertising, plugs or promotions. A feed’s primary purpose should be to provide informative and entertaining content to customers. Advertising only detracts from the customer experience. For more information, see Alexa Skills Kit Policy Testing
Choose thoughtful introductions and error messages. Choose error messages for your skills and introductions (preambles) for your feeds that are concise and informative.
Error messages should be 100 characters or less. For example, "Developer News is temporarily offline."
Preambles must start with “In…” or "From" for English skills or "Im" or "Von", "In", "Vom" or "Aus" for German skills and be 70 characters or less. For example, "In Developer News..."
Test your skill before submitting. The Developer Portal allows you to listen to and test your skill before submitting. By testing, you optimize the customer experience, and may catch issues that would result in your skill failing certification.
Host your feeds on reliable and fast servers. Make sure your feed URL is always available and that it loads quickly. To do so, you should ensure that your feed is hosted on a reliable server that is fast and responsive. There are many cloud providers that are relatively cheap and easy to work with. For example, Amazon Web Services (http://aws.amazon.com) offers options for hosting content feeds.
Tips for Text-to-Speech (TTS) Content
Use short sentences. Sentences designed to be read are often long and difficult to follow when spoken. Use short sentences to create a better listening experience and help your customers to more easily follow your content.
Use proper punctuation for pauses. Commas (,) and semicolons (;) result in short pauses. Periods (.), question marks (?) and exclamation points (!) result in longer pauses. Avoid using other punctuation as it could cause TTS issues.
Don't use HTML or SSML tags, URLs or special symbols. Using HTML or SSML tags, URLs and special symbols will create unpredictable TTS results. Provide plain text that can be easily read.
Keep your content in summary format. TTS is typically better suited to shorter summary content. A one paragraph news summary is typically much better than a two-page article when read aloud. – Audio feeds are better suited to longer material.
Limit a feed item to less than characters. If your feed item exceeds 4500 characters in length, your item will be truncated to the nearest sentence.
Tips for Audio Clip Content
Use high-quality audio formats. For a better listening experience, use an MP3 with a bit rate of at least 256kbps. Make sure audio is free of distracting background or other noises.
Provide a consistent volume for your audio content. Listen to your audio content using Alexa during the testing phase and make sure the volume of your audio clips match the volume of Alexa's speech for your feed's preamble. Ensure the volume of your feeds is consistent between feed items.