Smoke Test

This automates the full cycle of spinning up a new Mastra project and verifying the studio actually works in a real browser. It runs create-mastra with your chosen version tag and package manager, sets up a browser-enabled agent with Stagehand, then uses Chrome MCP to click through the UI and test agent chat responses. The validation is thorough: it checks that agents load, the chat interface works, and even sends test messages to verify the LLM integration. Most useful when you're testing a new Mastra release or need to verify a clean install works before recommending it to your team. Saves you from manually clicking through the same UI checks every time.

skills.sh installs: 2.5K
GitHub stars: 29.4K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add mastra-ai/mastra --skill smoke-test --agent claude-code

Installs into .claude/skills of the current project.

Files

Smoke Test Skill

Creates a new Mastra project using create-mastra@<tag> and performs smoke testing of the Mastra Studio in Chrome.

This skill is for Claude Code with Chrome MCP server. For MastraCode with built-in browser tools, use mastracode-smoke-test instead.

Usage

/smoke-test --directory <path> --name <project-name> --tag <version> [--pm <package-manager>] [--llm <provider>]
/smoke-test -d <path> -n <project-name> -t <version> [-p <package-manager>] [-l <provider>]