- Agent Prompt Quality BarUniversal quality bar and final audit rubric for any agent system prompt. Activate this whenever you are unsure which archetype skill applies, or as a final review pass before writing the system prompt. It defines the required run contract, completion criteria, fallback paths, response format, and anti-patterns every produced agent prompt must satisfy.mastra-ai/mastra28,462
- Builder Smoke TestSmoke test the Agent Builder feature branch end-to-end against a hermetic project scaffolded by the skill (linked to the current worktree). Covers workspace reconciliation, stored agents/skills CRUD, ownership, visibility, stars, registry/library Copy flow, picker allowlists, model policy, RBAC role gating, role impersonation UI, builder defaults, infrastructure diagnostics, channels, and Studio + Agent Builder UI. Trigger when validating the agent-builder feature branch, PRs that touch packagesmastra-ai/mastra28,462
- Code StandardsCode quality standards and style guide for reviewing pull requestsmastra-ai/mastra28,462
- Coding AgentAuthoring playbook for building agents that write, edit, review, or refactor code. Use this when the user asks for an agent that writes scripts, generates code, reviews pull requests, refactors a codebase, fixes bugs, implements features, writes tests, or works with programming languages such as Python, TypeScript, JavaScript, Go, Rust, SQL, or shell.mastra-ai/mastra28,462
- Configure Factory RulesConfigure board-owned lifecycle, policy, phase-semantics, and tool-result rules, plus integration event rulesmastra-ai/mastra28,462
- Content Writer AgentAuthoring playbook for building agents that draft written content — blog posts, marketing copy, social media posts, newsletters, product descriptions, landing pages, or ad copy. Use this when the user wants an agent that writes, drafts, or rewrites text for publication or marketing.mastra-ai/mastra28,462
- Customer Support AgentAuthoring playbook for building agents that triage and reply to customer messages — support tickets, email inquiries, chat questions, refund requests, or product issues. Use this when the user wants an agent that handles inbound customer questions, drafts replies, escalates hard cases, summarizes tickets, or follows a support playbook.mastra-ai/mastra28,462
- Debugging Difficult BugsUse early when debugging a medium or hard bug, especially when tests alone may not reveal the real runtime failure. Trigger this before extended TDD iteration when a bug involves runtime state, ordering, persistence, streaming, concurrency, UI/manual reproduction, external services, or when a red or newly passing test may not model the real issue. Skip only when the root cause is already directly proven by a stack trace or deterministic test that exercises the real runtime path.mastra-ai/mastra28,462
- Docs AuditAutonomous, report-only documentation review for Mastra docs. Use when auditing changed docs against source, validating contextual code examples or API coverage, checking canonical mastra-docs guidance, or running narrow deterministic checks.mastra-ai/mastra28,462
- Docs DiagramsConvert existing docs diagram images to Mermaid, and author new Mermaid diagrams for Mastra docs. Use when replacing an Excalidraw or PNG/JPG/SVG diagram with Mermaid, when a docs page needs a new diagram, when a diagram renders wrong in light or dark mode, or when auditing which docs images should become Mermaid. Triggers on: convert diagram, Excalidraw, mermaid, flowchart, diagram image, diagram styling, diagram looks wrong.mastra-ai/mastra28,462
- E2e Tests StudioREQUIRED when modifying any file in packages/playground-ui or packages/playground. Triggers on: React component creation/modification/refactoring, UI changes, new playground features, bug fixes affecting studio UI. Generates Playwright E2E tests that validate PRODUCT BEHAVIOR, not just UI states.mastra-ai/mastra28,462
- Factory Complete IssueMark a GitHub issue as done and update its status labelsmastra-ai/mastra28,462
- Factory Gitlab RereviewRe-review a GitLab merge request after new commits and reconcile the previous reviewmastra-ai/mastra28,462
- Factory PlanProduce a phased implementation plan for a Factory work item, then advance it to executemastra-ai/mastra28,462
- Factory RereviewRe-review a pull request after a push — reconcile the previous review against the new commits, look for new defects the push introduced, then a fresh pass over the whole PR, and finish with a verdict on the PRmastra-ai/mastra28,462
- Factory ReviewReview a pull request for a Factory work item — history and context first, then a verdict published on the PR — and mark the review completemastra-ai/mastra28,462
- Factory TriageTriage a Factory work item's issue — trace history, understand architecture, diagnose root cause, then advance the stagemastra-ai/mastra28,462
- General TasksDefault process for handling open-ended tasks that touch files, the shell, or the web.mastra-ai/mastra28,462
- Generic AssistantFallback authoring playbook for building general-purpose personal assistant agents that do not fit a more specific archetype. Use this only after checking the other archetype skills (coding, spreadsheet, research, customer-support, content-writer, ops-automation). Examples include summarizing emails, drafting short answers, capturing notes, or generic personal-helper agents.mastra-ai/mastra28,462
- Gh Bulk IssuesOrchestrate parallel Mastra Code headless instances to debug and fix multiple GitHub issues simultaneouslymastra-ai/mastra28,462
- Gh ReviewDraft and post direct, unhedged GitHub PR reviews and issue comments — every item is a required change with a pointer and reason, PR reviews land as "request changes" or "approve" (never a bare comment), and nothing is marked optional or deferred to a follow-up. Use whenever understand-pr or understand-issue (or any review) is about to draft or post to GitHub.mastra-ai/mastra28,462
- Herdr Kit WorkflowsSet up and operate Herdr Kit safely: install and configure the plugin and Mastra Code integration, manage Review and Work repository scope, open primary repository workspaces, synchronize managers, materialize or dematerialize managed worktrees, and update Herdr Kit settings or shortcuts.mastra-ai/mastra28,462
- Herdr Manager QueryQuery the authoritative global Herdr Review and Work Manager inventory, recommend actionable PR work, and explicitly materialize confirmed remote-only Review Manager records through the plugin's stable public CLI.mastra-ai/mastra28,462
- Label Core BugsReview open mastra-ai/mastra GitHub issues, identify direct @mastra/core bugs, and apply the @mastra/core label. Use when auditing issues for core ownership, labeling direct core bugs, or periodically reconciling the @mastra/core issue label.mastra-ai/mastra28,462
- Label Core BugsReview open mastra-ai/mastra GitHub issues, identify direct @mastra/core bugs, and apply the @mastra/core label. Use when auditing issues for core ownership, labeling direct core bugs, or periodically reconciling the @mastra/core issue label.mastra-ai/mastra28,462
- Label Core BugsReview open mastra-ai/mastra GitHub issues, identify direct @mastra/core bugs, and apply the @mastra/core label. Use when auditing issues for core ownership, labeling direct core bugs, or periodically reconciling the @mastra/core issue label.mastra-ai/mastra28,462
- Live Mastracode InstrumentationReproduce and measure a Mastra Code runtime bug against a real model by driving the built TUI headlessly in tmux while every layer (network, provider stream, run engine, TUI) appends timestamped JSONL. Use when a bug depends on real provider timing, streaming order, or event flow that mocked tests and fixtures may not reproduce — e.g. wrong token rates, flicker, stuck status, ordering races, or "only happens sometimes with a real model".mastra-ai/mastra28,462
- Mastra DocsDocumentation guidelines for Mastra. Use this skill when creating, editing, moving, deleting, or reviewing Mastra documentation, sidebars, redirects, or docs components.mastra-ai/mastra28,462
- Mastra FrontendHow to build Mastra frontend interfaces with the @mastra/playground-ui design system. This skill should be used when creating or modifying any application UI — pages, components, styling, or tokens — in this repo or in an external consumer of the design system. The docs site has its own styling and is out of scope.mastra-ai/mastra28,462
- Mastra Smoke TestSmoke 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.mastra-ai/mastra28,462
- Ops Automation AgentAuthoring playbook for building agents that automate recurring internal tasks — running scheduled workflows, syncing data between systems, posting notifications, processing inbound events, or executing operational runbooks. Use this when the user wants an agent that runs on a schedule, reacts to events, automates a process, syncs between tools, or handles ops/internal infrastructure.mastra-ai/mastra28,462
- Performance ReviewPerformance-focused code review for identifying bottlenecks and optimization opportunitiesmastra-ai/mastra28,462
- Playground Msw TestsREQUIRED and PRIMARY testing approach for packages/playground and packages/playground-ui. Triggers on: adding or modifying hooks, pages, route components, data-fetching code, React Query interactions, or any test work in these packages. Generates Vitest tests that drive the real @mastra/client-js + React Query stack through MSW handlers and typed fixtures derived from @mastra/client-js response types. This is the #1 way to test the playground packages — ABOVE Playwright E2E. Use Playwright only mastra-ai/mastra28,462
- Pr ExplainerUse when creating an approachable, self-contained HTML review aid for a pull request; explaining what changed, why it matters, how it works, and how it fits into the broader system; turning PR diffs, commits, tests, and architecture context into a local `.pr-review/` HTML page for reviewers; or helping reviewers understand complex code changes without dumping the full diff.mastra-ai/mastra28,462
- Pr Snapshot ReleaseGuide a Mastra maintainer through publishing an npm snapshot from a pull request or a specified repository branch. Use when asked to release, publish, or create a PR snapshot, branch snapshot, canary package build, or branch-specific npm tag. Performs source and branch preflight checks, requires confirmation before the irreversible publish, dispatches the existing Publish to npm workflow, monitors it, and reports installable package tags.mastra-ai/mastra28,462
- Pr SplitterUse when breaking a large, complex, messy, or hard-to-review pull request into multiple smaller PRs; planning stacked PRs; extracting independent changes from a branch; splitting mixed refactor and behavior changes; managing drift after review feedback; rebasing follow-up PRs as earlier PRs change; or preserving original branch intent while shipping incrementally.mastra-ai/mastra28,462
- Ralph PlanInteractive planning assistant that helps create focused, well-structured ralph-loop commands through collaborative conversationmastra-ai/mastra28,462
- React Best PracticesReact performance optimization guidelines from Mastra Engineering. This skill should be used when writing, reviewing, or refactoring React code to ensure optimal performance patterns. Triggers on tasks involving React components, data fetching, bundle optimization, or performance improvements.mastra-ai/mastra28,462
- Research AgentAuthoring playbook for building agents that search, read, and synthesize information into a report. Use this when the user wants an agent to research a topic, summarize sources, compare options, do competitive analysis, monitor news, generate briefs, or pull together a citation-backed report from the web or internal documents.mastra-ai/mastra28,462
- Research TasksProcess for answering research questions using the web and saving findings into the workspace.mastra-ai/mastra28,462
- Security ReviewSecurity-focused code review checklist for identifying vulnerabilitiesmastra-ai/mastra28,462
- Severe WeatherUse when conditions include storms, flooding, heat waves, or other hazards.mastra-ai/mastra28,462
- Smoke TestCreate a Mastra project using create-mastra and smoke test the studio in Chrome using Chrome MCP servermastra-ai/mastra28,462
- Spreadsheet AgentAuthoring playbook for building agents that read or write tabular data — Google Sheets, Microsoft Excel, CSV, Airtable, Notion databases, or any spreadsheet. Use this when the user wants an agent that updates rows, reads cells, computes totals, generates reports from sheets, syncs data between spreadsheets, or automates anything involving rows, columns, ranges, or worksheets.mastra-ai/mastra28,462
- Tailwind V4Tailwind CSS v4 usage guide and v3-to-v4 differences. This skill should be used when writing, reviewing, or refactoring any Tailwind CSS code in this repo. Triggers on tasks involving Tailwind classes, @theme blocks, CSS-first configuration, or cleanup of v3-era syntax.mastra-ai/mastra28,462
- Testing Core ProcessorsUse when writing or debugging integration tests for error processors in packages/core/src/processors/. Covers the MockLanguageModelV2 pattern for simulating API errors and verifying retry behavior, plus the build prerequisites for focused vitest runs.mastra-ai/mastra28,462
- Testing Core ProcessorsUse when writing or debugging integration tests for error processors in packages/core/src/processors/. Covers the MockLanguageModelV2 pattern for simulating API errors and verifying retry behavior, plus the build prerequisites for focused vitest runs.mastra-ai/mastra28,462
- Testing Mastracode TuiTesting mastracode TUI features interactively in Konsole. Covers model configuration, thread lifecycle, task state isolation, and common blockers.mastra-ai/mastra28,462
- Triage IssueFirst-contact triage for a GitHub issuemastra-ai/mastra28,462
- Understand IssueInvestigate a GitHub issue or reported bug the way a seasoned maintainer would — form an independent model before reading the thread's theories, trace the mechanism and history, verify the diagnosis, and return a concise briefing with a verdict and fix direction. Use for triage, root-cause analysis, or re-investigation.mastra-ai/mastra28,462
- Understand PrReview a PR the way a seasoned maintainer would — build an independent model before seeing the diff, investigate the implementation and history, verify material claims, and return a concise briefing. Use for any PR review, self-review, or re-review.mastra-ai/mastra28,462
- MastraComprehensive Mastra framework guide for building agents, workflows, tools, memory, workspaces, and storage with current APIs. Use for documentation lookup, API verification, TypeScript setup, common errors, migrations, and `mastra api` CLI tasks: inspect or call resources on local, Mastra platform, Trace Intelligence, or remote servers. For Mastra Factory operations, discover and activate the companion mastra-factory skill.mastra-ai/skills95
- Mastra FactoryOperate and supervise Mastra Factory through `mastra api factory`. Use for first-time Factory connection and login, status or queue summaries, project and work-item inspection, thread history and memory, metrics, health, decisions, attention, supervisor sessions, and user-authorized autonomous or interactive Factory operations on hosted, local, remote, or self-hosted servers.mastra-ai/skills95
- Mastra FactoryOperate and supervise Mastra Factory through `mastra api factory`. Use for first-time Factory connection and login, status or queue summaries, project and work-item inspection, thread history and memory, metrics, health, decisions, attention, supervisor sessions, and user-authorized autonomous or interactive Factory operations on hosted, local, remote, or self-hosted servers.mastra-ai/softwarefactory-template54
- Mastra FactoryOperate and supervise Mastra Factory through `mastra api factory`. Use for first-time Factory connection and login, status or queue summaries, project and work-item inspection, thread history and memory, metrics, health, decisions, attention, supervisor sessions, and user-authorized autonomous or interactive Factory operations on hosted, local, remote, or self-hosted servers.mastra-ai/softwarefactory-template54
- Apply CommentsApply pending @slide-comment markers written by the open-slide inspector tool. Use when the user asks to "apply comments", "process slide comments", "apply the inspector comments", or references markers left inside `slides/<id>/index.tsx`.mastra-ai/workshops27
- Apply CommentsApply pending @slide-comment markers written by the open-slide inspector tool. Use when the user asks to "apply comments", "process slide comments", "apply the inspector comments", or references markers left inside `slides/<id>/index.tsx`.mastra-ai/workshops27
- Apply CommentsApply pending @slide-comment markers written by the open-slide inspector tool. Use when the user asks to "apply comments", "process slide comments", "apply the inspector comments", or references markers left inside `slides/<id>/index.tsx`.mastra-ai/workshops27
- Create SlideCreate or extend a presentation in this open-slide repo using its theme templates. Use for new decks, new pages, and slide content; not for framework implementation.mastra-ai/workshops27
- Create SlideUse this skill when the user wants to create, draft, author, or generate new slides / a presentation in this open-slide repo. Triggers on phrases like "make slides about X", "create a presentation", "draft slides for", "new slide", or when the user asks to add content under `slides/`. Do NOT use for editing the framework itself — only for authoring content inside `slides/<id>/`.mastra-ai/workshops27