mastra-ai/workshops/mastra-factory
Claude Code and agent skill by mastra-ai/workshops
- community
Checking that the SKILL.md file is still in the repository.
Operate 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.
Install
npx vskill@latest install mastra-ai/workshops/mastra-factorySKILL.md
The same SKILL.md was published earlier as mastra-ai/skills/mastra-factory.
Mastra Factory Supervisor
Use mastra api factory as the operational control plane for Factory.
First use: connect before inspecting
Read `references/connection.md`. Check CLI availability, establish the user's actual Factory URL, and for platform-hosted deployments run mastra auth whoami. If logged out, offer mastra auth login rather than silently starting browser login. Local/self-hosted authentication may differ.
An explicit mastra api --url "$FACTORY_URL" factory project list works from an empty directory; no deployed repository or .mastra-project.json is required. Never assume a shared host, organization, project name, or ID. Preserve the explicit target on subsequent commands.
Default behavior
For status, inspection, diagnosis, queue review, or recommendation requests:
- Stay read-only.
- Select the sole or explicitly named project; report choices when ambiguous.
- Inspect project state, work items, metrics, thresholds, decisions, attention, and supervisor health/session.
- Correlate stages, revisions, sessions, decisions, and health findings.
- Report active/queued work, blocked or unhealthy items, running sessions, pending decisions, human attention, and one recommended next action.
- Execute a recommendation only when the current request or a previously granted operating scope authorizes it.
Required reference
Read `references/factory-supervisor.md` before running Factory commands for output control, contracts, the read-only workflow, mutation protocol, governance constraints, durable-session limitations, and error handling.
For “my work,” actual execution progress, thread messages, memory, or health interpretation, also read `references/session-inspection.md`. Distinguish card stages from running agents, historical messages from current memory, and agent claims from verified repository outcomes.
Safety boundary
- Never read or reveal
.env, bearer tokens, saved login contents, or platform/provider credentials. - Never invent IDs, stages, revisions, request IDs, or sessions.
- Establish the user's operating scope before mutating. Authorization may cover one action or grant standing autonomy over named projects, resources, action types, or objectives.
- Within a clear delegated scope, act without asking for confirmation before every mutation. Ask only when an action is ambiguous, outside scope, or materially more destructive than the granted authority.
- Fetch current state before a write, make the smallest in-scope change, then refetch and report IDs, revisions, and final state.
- Use transitions—not metadata updates—for stage changes, with the current revision and a fresh UUID request ID.
- Never use private HTTP routes to bypass unsupported CLI operations.
- If
work-item startlacks a supported durable user session, report the block; never substitute the supervisor session or invent a session UUID.
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingexamples/16-mcp-apps/.claude/skills/mastra-factory/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/mastra-ai/workshops/mastra-factory)