Skill guide · checked November 19, 2026

Mastra Factory Skill: Install and Use

Short answer: The Mastra Factory skill is an official agent skill from the Mastra team that teaches a coding agent to connect to and inspect a Mastra Factory through the mastra api factory command. Install only this skill with npx skills add mastra-ai/skills --skill mastra-factory. It does not install Factory itself; you need a running Factory.

Want the tool itself first? Read What Is Mastra Factory? Open-Source Software Factory.

Install the Mastra Factory skills

The official README gives these commands. The first installs only the Factory skill and asks you to pick the agent and scope. The second installs everything in the repository.

# only the Factory skill (interactive agent and scope choice)
npx skills add mastra-ai/skills --skill mastra-factory

# both skills in the repository
npx skills add mastra-ai/skills

# global install for one named agent, then check it is linked
npx skills add mastra-ai/skills --skill mastra-factory --agent <agent> -g
npx skills list -g

# manual route: clone, then point your agent at the skills folder
git clone https://github.com/mastra-ai/skills.git

Source: mastra-ai/skills and the official docs. We do not host a copy, so you always install the current version.

What each Mastra Factory skill does

The repository ships two skills, not a long list: mastra and mastra-factory. The table shows those two plus the three reference files the Factory skill reads. Descriptions are our own short summaries of the README; open the repository for the real instructions.

SkillWhat it doesUse when
mastra-factoryLets an agent connect to a Factory and look at its projects, work items, sessions, health and attention items.You want an agent to report on or operate a Factory you already run.
references/connection.mdExplains how to reach a Factory by its URL, check the CLI and log in.This is your first time pointing an agent at a Factory.
references/factory-cli.mdDescribes the Factory commands, their output and how changes are made safely.The agent needs to do more than read.
references/session-inspection.mdShows how to follow a work item into its session, thread and memory.You want to know what an agent actually did on a card.
mastraA separate, larger skill for building with the Mastra framework itself, with reference files for setup, docs lookup, errors, migrations and the platform.You are writing Mastra agents or workflows, not supervising a Factory.

Connect an agent to your Factory

These steps follow the skill's own connection reference. They assume a Factory already exists; the skill does not create one.

  1. Install the skill with npx skills add mastra-ai/skills --skill mastra-factory and choose your agent and scope.
  2. Check the Mastra CLI is present with mastra --version, and that mastra api factory --help lists the factory command.
  3. For a platform-hosted Factory, check your login with mastra auth whoami, and sign in with mastra auth login if needed.
  4. Give the agent your Factory server URL (the base URL, not a board page) and let it list projects with mastra api --url "$FACTORY_URL" factory project list.
  5. Ask for a status summary first. The skill is written to stay read-only for status and inspection requests.

License and what we did not verify

We read the LICENSE file in mastra-ai/skills on November 19, 2026. It is the Apache License 2.0 (copyright Kepler Software, Inc., 2026), and the README and the skill front matter also say Apache-2.0. GitHub shows its license field as NOASSERTION for this repository, which is why we checked the file text ourselves. We have not run these skills ourselves; every command and description here comes from the repository files. The repository has two skills. We did not verify which agents the skills CLI supports beyond what the README says, or any pricing for hosted Factory. See also how to install skills in Antigravity, Claude Code and Codex and our full Skills library.

FAQ

What is the Mastra Factory skill?

It is an official skill in the mastra-ai/skills repository that teaches a coding agent to operate Mastra Factory through the mastra api factory command: connecting, checking project and queue status, and inspecting work items and sessions.

How do I install the Mastra Factory skill?

Run npx skills add mastra-ai/skills --skill mastra-factory and pick your agent and scope. For a global install name the agent yourself with --agent <agent> -g, then verify with npx skills list -g.

Does the skill install Mastra Factory?

No. It only gives your agent instructions for working with a Factory. You still need a Factory to connect to, such as the open-source template described on our Mastra Factory page.

Which agents does it work with?

The README does not list agents. It says to choose a supported agent during install and warns that PromptScript does not support global installs. Check npx skills --help for the current list.

What is the difference between the mastra and mastra-factory skills?

The mastra skill covers building with the Mastra framework. The mastra-factory skill is only for operating a Factory. Install just the one you need.