Agent skill

Factory Triage

by mastra-ai in mastra-ai/mastra

Triage a Factory work item's issue — trace history, understand architecture, diagnose root cause, then advance the stage

Custom licenceAuto-check passedDevelopment

Install Factory Triage

skills CLI
$ npx skills add mastra-ai/mastra --skill factory-triage -a claude-code

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

GitHub CLI
$ gh skill install mastra-ai/mastra factory-triage --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/mastracode/factory/factory-skills/factory-triage .claude/skills/factory-triage && 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
factory-triage
GitHub stars
29k
Token cost
~4.5k tokens
SKILL.md length
1,860 words
Files
1
Skills in repo
44
Repo updated
First seen
Licence
Custom licence

At a glance

Triage a Factory work item's issue — trace history, understand architecture, diagnose root cause, then advance the stage

  • Works in 5 steps: Identify the Issue → Related Issues & Prior Work → Investigation → …
  • Tasks that involve Root cause analysis
  • SKILL.md covers Phase 1: Identify the Issue, Phase 2: Related Issues &…, Phase 3: Investigation and Phase 4: Diagnosis, plus 3 more sections
  • Calls gh and git; reaches github.com

What it does

Factory Triage is an agent skill from mastra-ai/mastra. Triage a Factory work item's issue — trace history, understand architecture, diagnose root cause, then advance the stage

Its SKILL.md is about 4.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Root cause analysis. It works with GitHub. 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 Root cause analysis

Example prompts

  • “/factory-triage”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Identify the Issue
  2. Related Issues & Prior Work
  3. Investigation
  4. Diagnosis
  5. GitHub Handoff & Transition

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

    Shell commands in SKILL.md call:

    • gh
    • git

    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:

    • github.com

    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

Factory Triage loads about 4.5k tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 1,860 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~34
When it runs · the whole SKILL.md, loaded when a task matches
~4.5k

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 passed

The automated check found no risky patterns in SKILL.md.

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); files beside SKILL.md 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,860 words (~4,461 tokens).

“Investigate the GitHub or Linear issue behind this Factory work item — trace the history of related code, understand the architecture involved, and diagnose whether the issue is valid and what's actually causing it. Finish by posting your distilled understanding…”

— opening of SKILL.md by mastra-ai, Custom licence
name
factory-triage

Read the full SKILL.md on GitHub

Files

Just SKILL.md in mastracode/factory/factory-skills/factory-triage of mastra-ai/mastra.

Open the folder on GitHubat commit b98829a

Compare with similar skills

Factory Triage 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.

Factory Triage compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Factory Triage this skillmastra-ai/mastra29k—~4.5kAutomated safety check: PassCustom licence
OpenROAD Bug FixerThe-OpenROAD-Project/OpenROAD3.2k—~784Automated safety check: PassBSD-3-Clause
Octocode Code Researchbgauryy/octocode949—~1.5kAutomated safety check: PassMIT
Triagebot Action Bug Triagewithastro/astro63k—~639Automated safety check: PassCustom licence
CI TriageMentra-Community/MentraOS2.4k—~582Automated safety check: PassApache-2.0
Stereopy Issue ResponderSTOmics/Stereopy293—~1.3kAutomated safety check: PassMIT

Similar skills

  • OpenROAD Bug Fixer

    The-OpenROAD-Project/OpenROAD

    Fixes an OpenROAD bug from a GitHub issue or error code: finds the root cause, implements the fix, adds a regression test and prepares a signed-off commit.

    3.2k GitHub stars~784 tokensUpdated today
    DevelopmentAuto-check passed
  • Octocode Code Research

    bgauryy/octocode

    Researches code with evidence: traces callers, imports and cross-repo links, diagnoses failures and reports findings with exact file and line references and a confidence label.

    949 GitHub stars~1.5k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Official

    Takes a bug report for the triagebot-action GitHub Action through reproduction, root-cause diagnosis, an intended-behavior check and a fix attempt.

    63k GitHub stars~639 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • CI Triage

    Mentra-Community/MentraOS

    Triage failing GitHub PR checks: list failures with gh, fetch capped Actions logs, skip non-Actions checks, and summarize root cause.

    2.4k GitHub stars~582 tokensUpdated today
    DevelopmentAuto-check passed
  • Stereopy Issue Responder

    STOmics/Stereopy

    Generates professional maintainer-grade responses for Stereopy GitHub issues.

    293 GitHub stars~1.3k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Reviewing Pull Requests

    Shopify/shopify-app-js

    Official

    Reviews pull requests for Shopify/shopify-app-js with comprehensive analysis including semver compliance (MAJOR/MINOR/PATCH classification), single responsibility validation, pattern consistency…

    541 GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-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
  • Mastra Smoke Test

    mastra-ai/mastra

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

    29k GitHub stars~4k 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

Works with

Categories

Questions about Factory Triage

What does Factory Triage do?

Triage a Factory work item's issue — trace history, understand architecture, diagnose root cause, then advance the stage. Factory Triage is an agent skill from mastra-ai/mastra.

When should I use Factory Triage?

Factory Triage fits situations like: tasks that involve Root cause analysis.

How do I install Factory Triage in Claude Code?

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

How do I install Factory Triage in Codex?

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

Can I use Factory Triage 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 factory-triage -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/factory-triage, .gemini/skills/factory-triage, .github/skills/factory-triage and .opencode/skills/factory-triage in your project.

What does Factory Triage need to run?

Going by SKILL.md and its folder, Factory Triage needs the command-line tools its instructions call (gh and git).

Does Factory Triage access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Factory Triage safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Factory Triage use?

Factory Triage 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 Factory Triage use?

About 4.5k tokens (SKILL.md is roughly 18k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Factory Triage?

Skills that share tags, products or a category with Factory Triage: OpenROAD Bug Fixer (The-OpenROAD-Project/OpenROAD, 3.2k stars), Octocode Code Research (bgauryy/octocode, 949 stars), Triagebot Action Bug Triage (withastro/astro, 63k stars) and CI Triage (Mentra-Community/MentraOS, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Factory Triage?

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.