A sample skill demonstrating test automation approaches for Alexa Skills using Node.js, the ASK CLI, and the Skill Invocation API with hands-on lab guides.
git clone https://github.com/alexa-samples/skill-sample-nodejs-test-automation.gitThis Node.js sample skill teaches test automation techniques for Alexa Skills through eight progressive lab guides covering SMAPI, the ASK CLI, Service Simulator, Skill Invocation API, and Simulation API. The skill implements a number guessing game to demonstrate single-turn conversations, multi-turn conversations, multi-path conversations, and proactive skill monitoring. Developers use this reference project to learn how to systematically test Alexa skill behavior and automate quality assurance workflows. The labs require an Amazon Developer Account, AWS account, Node.js, and the ask-cli tool to get started.
Clone the repository and install Node.js and ask-cli. Follow the eight sequential lab guides from Lab01 through Lab08, which cover SMAPI, Service Simulator, Skill Invocation API, and test SDK setup. Each lab builds on the number guessing game skill to teach testing concepts and practices.
Learning Alexa skill test automation workflows
Setting up automated testing with ASK CLI and Simulation API
Testing multi-turn and multi-path conversational flows
Implementing proactive skill monitoring
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/alexa-samples/skill-sample-nodejs-test-automationCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Create a Node.js script to automate testing for an Alexa Skill named [SKILL_NAME] that operates in the [INDUSTRY] industry. The script should test the following functionalities: [FUNCTIONALITY_1], [FUNCTIONALITY_2], and [FUNCTIONALITY_3]. Ensure the script includes assertions to validate the expected behavior and provides detailed error messages for debugging.
# Alexa Skill Test Automation Report ## Test Summary - **Skill Name**: WeatherForecast - **Industry**: Weather Services - **Tested Functionalities**: - Current Weather Query - 5-Day Forecast Query - Location-Based Weather Alerts ## Test Results ### Current Weather Query ✅ **Test Passed**: The skill correctly returned the current temperature and conditions for the specified location. ### 5-Day Forecast Query ✅ **Test Passed**: The skill accurately provided the 5-day weather forecast with high and low temperatures. ### Location-Based Weather Alerts ❌ **Test Failed**: The skill did not trigger a weather alert for the specified severe weather condition. **Error Message**: 'Location-based alert service is currently unavailable. Please try again later.' ## Recommendations 1. Investigate the issue with the location-based alert service to ensure it is functioning correctly. 2. Add more test cases to cover edge cases, such as invalid locations or network connectivity issues. 3. Implement logging to track the performance and reliability of the skill over time.
AI-powered document workflows for healthcare
Automate your browser workflows effortlessly
Get more done every day with Microsoft Teams – powered by AI
Automate your spreadsheet tasks with AI power
Agentic AI Workflow platform
Connected workspace for docs, wikis, and projects
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan