Agent skill

Live Mastracode Instrumentation

by mastra-ai in mastra-ai/mastra

Reproduce 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…

Custom licenceAuto-check passedTesting & QA

Install Live Mastracode Instrumentation

skills CLI
$ npx skills add mastra-ai/mastra --skill live-mastracode-instrumentation -a claude-code

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

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

At a glance

Reproduce 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…

  • Works in 5 steps: Add temporary diagnostics → Build and verify the instrumentation… → Drive the TUI in tmux → …
  • A bug depends on real provider timing
  • SKILL.md covers Cost and consent, 1. Add temporary diagnostics, 2. Build and verify the… and 3. Drive the TUI in tmux, plus 2 more sections
  • Calls pnpm, rg and git

What it does

Live Mastracode Instrumentation is an agent skill from mastra-ai/mastra. Reproduce 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".

Its SKILL.md is about 2k 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 Testing & QA. It works with Mastra and tmux. The repository describes itself as: Mastra is the modern TypeScript framework for AI-powered applications and agents.

When your agent uses it

  • A bug depends on real provider timing
  • Streaming order
  • Event flow that mocked tests and fixtures may not reproduce — e.g

Example prompts

  • “only happens sometimes with a real model”
  • “/live-mastracode-instrumentation”

Workflow steps

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

  1. Add temporary diagnostics
  2. Build and verify the instrumentation shipped
  3. Drive the TUI in tmux
  4. Analyze per step
  5. Clean up

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:

    • pnpm
    • rg
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pnpm and git, which can reach the network depending on how they are called.

    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

Live Mastracode Instrumentation loads about 2k tokens when it runs. Until then it costs about 118 tokens; SKILL.md has 726 words of instructions outside code blocks.

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

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 726 words (~1,966 tokens).

“Run the real TUI against a real model, have an agent type the prompts, and log timestamps at each layer. Comparing the layers step by step shows where timing or ordering goes wrong: at the provider, in the network wrapper…”

— opening of SKILL.md by mastra-ai, Custom licence
name
live-mastracode-instrumentation

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/live-mastracode-instrumentation of mastra-ai/mastra.

Open the folder on GitHubat commit b98829a

Compare with similar skills

Live Mastracode Instrumentation 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.

Live Mastracode Instrumentation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Live Mastracode Instrumentation this skillmastra-ai/mastra29k—~2kAutomated safety check: PassCustom licence
CodexBar Live QAsteipete/CodexBar22k—~1.2kAutomated safety check: PassMIT
Codex Plugin QAcode-yeongyu/oh-my-openagent70k—~1.9kAutomated safety check: PassCustom licence
OpenCode QA Toolkitcode-yeongyu/oh-my-openagent70k—~2.9kAutomated safety check: PassCustom licence
Drive MiMo CodeXiaomiMiMo/MiMo-Code14k—~3.9kAutomated safety check: PassMIT
Senpi Agent QA Harnesscode-yeongyu/senpi474—~2.7kAutomated safety check: NotesMIT

Similar skills

  • CodexBar Live QA

    steipete/CodexBar

    Runs live QA for the CodexBar app: provider usage matrix checks through its packaged CLI, config validation and menu checks, with 1Password-backed credentials handled safely.

    22k GitHub stars~1.2k tokensUpdated today
    Testing & QAAuto-check passed
  • Codex Plugin QA

    code-yeongyu/oh-my-openagent

    Tests the omo Codex plugin in an isolated CODEX_HOME with a local mock model, proving hooks fired through app-server notifications without touching ~/.codex.

    70k GitHub stars~1.9k tokensUpdated today
    Testing & QAAuto-check passed
  • OpenCode QA Toolkit

    code-yeongyu/oh-my-openagent

    Tests the opencode coding agent itself: its CLI, server, plugin hooks and events, the terminal UI under tmux, and its SQLite session database, using tested helper scripts.

    70k GitHub stars~2.9k tokensUpdated today
    Testing & QAAuto-check passed
  • Drive MiMo Code

    XiaomiMiMo/MiMo-Code

    Lets one MiMoCode process drive another, headless with JSON events or interactively through tmux, to test behavior and visual regressions with parseable evidence.

    14k GitHub stars~3.9k tokensUpdated 2 days ago
    Testing & QAAuto-check passed
  • Senpi Agent QA Harness

    code-yeongyu/senpi

    Checks changes to the senpi coding agent by driving the real CLI from source in an isolated sandbox, over RPC, terminal UI, mock model and CLI smoke channels.

    474 GitHub stars~2.7k tokensUpdated today
    Testing & QAAuto-check: notes
  • tmux Real User Testing

    QwenLM/qwen-code

    Drives Qwen Code in a real tmux session the way a user would and saves a readable step-by-step transcript of each screen for maintainers to review.

    28k GitHub stars~2.3k tokensUpdated today
    Testing & QAAuto-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 Live Mastracode Instrumentation

What does Live Mastracode Instrumentation do?

Reproduce 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…. Live Mastracode Instrumentation is an agent skill from mastra-ai/mastra. Reproduce 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.

When should I use Live Mastracode Instrumentation?

Live Mastracode Instrumentation fits situations like: A bug depends on real provider timing; streaming order; event flow that mocked tests and fixtures may not reproduce — e.g.

How do I install Live Mastracode Instrumentation in Claude Code?

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

How do I install Live Mastracode Instrumentation in Codex?

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

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

What does Live Mastracode Instrumentation need to run?

Going by SKILL.md and its folder, Live Mastracode Instrumentation needs the command-line tools its instructions call (pnpm, rg and git).

Does Live Mastracode Instrumentation access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Live Mastracode Instrumentation 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 Live Mastracode Instrumentation use?

Live Mastracode Instrumentation 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 Live Mastracode Instrumentation use?

About 2k tokens (SKILL.md is roughly 7.9k 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 Live Mastracode Instrumentation?

Skills that share tags, products or a category with Live Mastracode Instrumentation: CodexBar Live QA (steipete/CodexBar, 22k stars), Codex Plugin QA (code-yeongyu/oh-my-openagent, 70k stars), OpenCode QA Toolkit (code-yeongyu/oh-my-openagent, 70k stars) and Drive MiMo Code (XiaomiMiMo/MiMo-Code, 14k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Live Mastracode Instrumentation?

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.