Agent skill

Mastra Smoke Test

by mastra-ai in mastra-ai/mastra

Smoke test Mastra projects locally or deploy to staging/production.

Custom licenceAuto-check: notesTesting & QA

Install Mastra Smoke Test

skills CLI
$ npx skills add mastra-ai/mastra --skill mastra-smoke-test -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mastra-ai/mastra mastra-smoke-test --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mastra-ai/mastra.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/mastra-smoke-test .claude/skills/mastra-smoke-test && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mastra-smoke-test
GitHub stars
29k
Token cost
~4k tokens
SKILL.md length
1,090 words
Files
32 (incl. scripts, references)
Skills in repo
44
Repo updated
First seen
Licence
Custom licence

At a glance

Smoke test Mastra projects locally or deploy to staging/production.

  • Works in 3 steps: Read the reference file for each test… → Execute the steps in that reference file → Mark the test complete before moving to…
  • Tasks that involve QA and bug reports
  • SKILL.md covers Release smoke workflows, ⚠️ Mandatory Test Checklist, Local Studio Browser Smoke and Usage, plus 8 more sections
  • Calls gh, curl and pnpm; reaches projects.mastra.ai and projects.staging.mastra.ai

What it does

Mastra Smoke Test is an agent skill from mastra-ai/mastra. Smoke test Mastra projects locally or deploy to staging/production. Tests Studio UI, agents, tools, workflows, traces, memory, and more. Supports both local development and cloud deployments.

Its SKILL.md is about 4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 33 other files, including scripts and reference files (for example `references/alpha-publish.md`, `references/alpha-versioning-pr.md` and `references/architecture.md`).

It sits in Testing & QA, covering QA and bug reports and Deployment. It works with Mastra. The repository describes itself as: Mastra is the modern TypeScript framework for AI-powered applications and agents.

When your agent uses it

  • Tasks that involve QA and bug reports
  • Tasks that involve Deployment

Example prompts

  • “/mastra-smoke-test”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Read the reference file for each test you're about to run
  2. Execute the steps in that reference file
  3. Mark the test complete before moving to the next

What it can do on your machine

Read from SKILL.md and the folder at commit b98829a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • gh
    • curl
    • pnpm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • projects.mastra.ai
    • projects.staging.mastra.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Mastra Smoke Test loads about 4k tokens when it runs, and up to ~31k if it reads all its reference files. Until then it costs about 52 tokens; SKILL.md has 1,090 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~31k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:239
    - LLM API key in env or `.env`

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,090 words (~4,029 tokens).

“Comprehensive smoke testing for Mastra projects.”

— opening of SKILL.md by mastra-ai, Custom licence
name
mastra-smoke-test

Read the full SKILL.md on GitHub

Files

SKILL.md and 31 other files (scripts, references) in .claude/skills/mastra-smoke-test of mastra-ai/mastra.

  • SKILL.md
  • references/alpha-publish.md
  • references/alpha-versioning-pr.md
  • references/architecture.md
  • references/cloud-advanced.md
  • references/cloud-deploy.md
  • references/common-errors.md
  • references/environment-variables.md
  • references/gcp-debugging.md
  • references/local-setup.md
  • references/release-scope-discovery.md
  • references/release-smoke.md
  • references/stable-partial-publish-recovery.md
  • references/stable-release-smoke.md
  • references/storage-provider-migration-smoke.md
  • references/targeted-feature-smoke.md
  • references/tests/agents.md
  • references/tests/errors.md
  • references/tests/experiments.md
  • … and 13 more

Open the folder on GitHubat commit b98829a

Compare with similar skills

Mastra Smoke Test next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Mastra Smoke Test compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mastra Smoke Test this skillmastra-ai/mastra29k—~4kAutomated safety check: NotesCustom licence
DeerFlow Smoke Testbytedance/deer-flow84k—~2.5kAutomated safety check: NotesMIT
Skyvern Deployment Smoke TestSkyvern-AI/skyvern23k—~1.5kAutomated safety check: PassAGPL-3.0
Azure DeploymentEmeaAppGbb/spec2cloud100—~1.8kAutomated safety check: PassMIT
Sdaf Sap InstallationAzure/sap-automation146—~1.5kAutomated safety check: PassMIT
Deploy Dynamo Recipeai-dynamo/dynamo8.3k—~4.7kAutomated safety check: PassApache-2.0

Similar skills

  • DeerFlow Smoke Test

    bytedance/deer-flow

    Walks through an end-to-end smoke test of a DeerFlow deployment: pull the latest code, deploy with Docker or locally, verify services, run health checks and write a report.

    84k GitHub stars~2.5k tokensUpdated today
    Testing & QAAuto-check: notes
  • Smoke-tests a Skyvern deployment by checking the backend API, frontend rendering, browser session provisioning and workflow execution in sequence.

    23k GitHub stars~1.5k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Azure Deployment

    EmeaAppGbb/spec2cloud

    Provision Azure infrastructure, deploy to Azure Container Apps, and verify via smoke tests.

    100 GitHub stars~1.8k tokensUpdated 5 mo ago
    Testing & QAAuto-check passed
  • Sdaf Sap Installation

    Azure/sap-automation

    Official

    Guide SDAF operating-system, database, and SAP installation after the SAP-system workspace and reviewed media are ready.

    146 GitHub stars~1.5k tokensUpdated 3 days ago
    Testing & QAAuto-check passed
  • Deploy Dynamo Recipe

    ai-dynamo/dynamo

    Deploys one assigned DynamoGraphDeployment and proves it with an OpenAI-compatible smoke test.

    8.3k GitHub stars~4.7k tokensUpdated today
    Testing & QAAuto-check passed
  • Vss E2E Smoke

    open-edge-platform/edge-ai-libraries

    Run this skill whenever the user asks to verify my VSS install works, smoke test VSS, check whether the deployment succeeded, or run an end-to-end test of summary/search for the…

    171 GitHub stars~1.5k tokensUpdated yesterday
    Testing & QAAuto-check passed

More from mastra-ai/mastra

All 44 skills in this repo
  • Docs Audit

    mastra-ai/mastra

    Autonomous, report-only documentation review for Mastra docs.

    29k GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Builder Smoke Test

    mastra-ai/mastra

    Smoke test the Agent Builder feature branch end-to-end against a hermetic project scaffolded by the skill (linked to the current worktree).

    29k GitHub stars~11k tokensUpdated today
    Auto-check: notes
  • React Best Practices

    mastra-ai/mastra

    React performance optimization guidelines from Mastra Engineering.

    29k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Agent Prompt Quality Bar

    mastra-ai/mastra

    Universal quality bar and final audit rubric for any agent system prompt.

    29k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Coding Agent

    mastra-ai/mastra

    Authoring playbook for building agents that write, edit, review, or refactor code.

    29k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Content Writer Agent

    mastra-ai/mastra

    Authoring playbook for building agents that draft written content — blog posts, marketing copy, social media posts, newsletters, product descriptions, landing pages, or ad copy.

    29k GitHub stars~1.3k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Mastra Smoke Test

What does Mastra Smoke Test do?

Smoke test Mastra projects locally or deploy to staging/production. Mastra Smoke Test is an agent skill from mastra-ai/mastra. Smoke test Mastra projects locally or deploy to staging/production.

When should I use Mastra Smoke Test?

Mastra Smoke Test fits situations like: tasks that involve QA and bug reports; tasks that involve Deployment.

How do I install Mastra Smoke Test in Claude Code?

Run `npx skills add mastra-ai/mastra --skill mastra-smoke-test -a claude-code`. Or copy the skill folder (.claude/skills/mastra-smoke-test in mastra-ai/mastra) into .claude/skills/mastra-smoke-test in your project. Claude Code loads it when a task matches its description.

How do I install Mastra Smoke Test in Codex?

Run `npx skills add mastra-ai/mastra --skill mastra-smoke-test -a codex`. Or copy the skill folder (.claude/skills/mastra-smoke-test in mastra-ai/mastra) into .agents/skills/mastra-smoke-test in your project. Codex loads it when a task matches its description.

Can I use Mastra Smoke Test in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mastra-ai/mastra --skill mastra-smoke-test -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mastra-smoke-test, .gemini/skills/mastra-smoke-test, .github/skills/mastra-smoke-test and .opencode/skills/mastra-smoke-test in your project.

What does Mastra Smoke Test need to run?

Going by SKILL.md and its folder, Mastra Smoke Test needs the command-line tools its instructions call (gh, curl and pnpm).

Does Mastra Smoke Test access the network?

SKILL.md names 2 domains. In commands or code: projects.mastra.ai and projects.staging.mastra.ai; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Mastra Smoke Test safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Mastra Smoke Test use?

Mastra Smoke Test has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Mastra Smoke Test use?

About 4k tokens (SKILL.md is roughly 16k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 27k tokens, read only when the agent opens those files.

What are the alternatives to Mastra Smoke Test?

Skills that share tags, products or a category with Mastra Smoke Test: DeerFlow Smoke Test (bytedance/deer-flow, 84k stars), Skyvern Deployment Smoke Test (Skyvern-AI/skyvern, 23k stars), Azure Deployment (EmeaAppGbb/spec2cloud, 100 stars) and Sdaf Sap Installation (Azure/sap-automation, 146 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mastra Smoke Test?

mastra-ai (a GitHub organization) maintains it in mastra-ai/mastra, which has 28,698 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on October 11, 2026.

Source: mastra-ai/mastra on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.