Mastra System Check

Mastra System Check

A comprehensive Claude Code skill for validating Mastra AI agent projects. This skill performs **66 checks** across **10 categories** to identify configuration issues, missing best practices, and potential problems before they cause runtime errors.

Installation

Option 1: npx (Recommended)

npx mastra-system-check

Option 2: One-line install

curl -fsSL https://raw.githubusercontent.com/goldk3y/mastra-system-check/main/install.sh | bash

Option 3: Git clone

git clone https://github.com/goldk3y/mastra-system-check.git ~/.claude/skills/mastra-system-check

Option 4: Manual

Download and copy this directory to:

~/.claude/skills/mastra-system-check/

Verification

The skill will automatically activate when working with Mastra projects. You can verify installation by asking Claude Code to perform a system check on your Mastra project.

---

What It Checks

Priority Levels

Badge	Level	Description	Action
🔴	CRITICAL	System won't function	Fix immediately
🟠	HIGH	Major functionality issues	Fix before deployment
🟡	MEDIUM	Quality and maintainability	Fix when possible
🟢	LOW	Performance and cost	Nice to have

Check Categories

#	Category	Rules	Priority	Key Checks
1	Configuration & Setup	6	🔴 CRITICAL	Storage, env vars, TypeScript, entry points
2	Agent Configuration	6	🟠 HIGH	Model format, instructions, tools, memory
3	Workflow Configuration	6	🟠 HIGH	.commit(), schemas, steps, error handling
4	Context & Data Flow	8	🟠 HIGH	Type safety, middleware, propagation
5	Prompt Engineering	10	🟠 HIGH	Structure, token efficiency, examples
6	Memory Configuration	6	🟡 MEDIUM	Stor