Agent skill

Mastra

Comprehensive Mastra framework guide. An agent skill from LiorVainer/data-israel.

Apache-2.0Auto-check passedAI & LLM Engineering

Install Mastra

skills CLI

$ npx skills add LiorVainer/data-israel --skill mastra -a claude-code

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

GitHub CLI

$ gh skill install LiorVainer/data-israel mastra --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/LiorVainer/data-israel.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/mastra .claude/skills/mastra && 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/

Paste into Claude Code

Install the "mastra" agent skill from https://github.com/LiorVainer/data-israel/tree/main/.agents/skills/mastra into .claude/skills/mastra/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mastra", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/LiorVainer/data-israel/tree/main/.agents/skills/mastra

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add LiorVainer/data-israel --skill mastra -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install LiorVainer/data-israel mastra --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LiorVainer/data-israel.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/mastra .agents/skills/mastra && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "mastra" agent skill from https://github.com/LiorVainer/data-israel/tree/main/.agents/skills/mastra into .agents/skills/mastra/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mastra", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add LiorVainer/data-israel --skill mastra -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install LiorVainer/data-israel mastra --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LiorVainer/data-israel.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/mastra .cursor/skills/mastra && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "mastra" agent skill from https://github.com/LiorVainer/data-israel/tree/main/.agents/skills/mastra into .cursor/skills/mastra/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mastra", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/LiorVainer/data-israel.git --path .agents/skills/mastra

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add LiorVainer/data-israel --skill mastra -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install LiorVainer/data-israel mastra --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LiorVainer/data-israel.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/mastra .gemini/skills/mastra && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "mastra" agent skill from https://github.com/LiorVainer/data-israel/tree/main/.agents/skills/mastra into .gemini/skills/mastra/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mastra", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install LiorVainer/data-israel mastra

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add LiorVainer/data-israel --skill mastra -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/LiorVainer/data-israel.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/mastra .github/skills/mastra && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "mastra" agent skill from https://github.com/LiorVainer/data-israel/tree/main/.agents/skills/mastra into .github/skills/mastra/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mastra", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add LiorVainer/data-israel --skill mastra -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install LiorVainer/data-israel mastra --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LiorVainer/data-israel.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/mastra .opencode/skills/mastra && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "mastra" agent skill from https://github.com/LiorVainer/data-israel/tree/main/.agents/skills/mastra into .opencode/skills/mastra/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mastra", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: mastra
GitHub stars: 130
Used in: 2 other repos
Token cost: ~1.6k tokens
SKILL.md length: 513 words
Files: 6 (incl. references)
Skills in repo: 6
Repo updated: May 13, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Comprehensive Mastra framework guide. An agent skill from LiorVainer/data-israel.

Works in 3 steps: Embedded docs first (if packages… → Source code second (if packages installed) → Remote docs third (if packages not…
All Mastra development to ensure youre using current APIs from the installed version
SKILL.md covers ⚠️ Critical: Do not trust…, Prerequisites, Documentation lookup guide and Core concepts, plus 4 more sections
Calls npm; reaches mastra.ai

What it does

Mastra is an agent skill from LiorVainer/data-israel. Comprehensive Mastra framework guide. Teaches how to find current documentation, verify API signatures, and build agents and workflows. Covers documentation lookup strategies (embedded docs, remote docs), core concepts (agents vs workflows, tools, memory, RAG), TypeScript requirements, and common patterns. Use this skill for all Mastra development to ensure you're using current APIs from the installed version or latest documentation.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files (for example `references/common-errors.md`, `references/create-mastra.md` and `references/embedded-docs.md`).

It sits in AI & LLM Engineering. It works with Mastra and TypeScript. The repository describes itself as: AI agent network that connects to Israeli open data sources - ask questions in Hebrew, get answers grounded in real data with charts and sources. The licence is Apache-2.0.

When your agent uses it

All Mastra development to ensure youre using current APIs from the installed version
Latest documentation

Example prompts

“/mastra”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

Embedded docs first (if packages installed)
Source code second (if packages installed)
Remote docs third (if packages not installed)

What it can do on your machine

Read from SKILL.md and the folder at commit 6522504. 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:
- npm
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:
- mastra.ai
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

Mastra loads about 1.6k tokens when it runs, and up to ~9.2k if it reads all its reference files. Until then it costs about 111 tokens; SKILL.md has 513 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~111
When it runs · the whole SKILL.md, loaded when a task matches: ~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~9.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

The full file from LiorVainer/data-israel at commit 6522504, republished under its Apache-2.0 licence (© LiorVainer). 513 words, ~1,594 tokens.

Download SKILL.mdSave it as .claude/skills/mastra/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.

name: mastra
description: Comprehensive Mastra framework guide. Teaches how to find current documentation, verify API signatures, and build agents and workflows. Covers documentation lookup strategies (embedded docs, remote docs), core concepts (agents vs workflows, tools, memory, RAG), TypeScript requirements, and common patterns. Use this skill for all Mastra development to ensure you're using current APIs from the installed version or latest documentation.
license: Apache-2.0
metadata.author: Mastra
metadata.version: 2.0.0
metadata.repository: https://github.com/mastra-ai/skills

Mastra Framework Guide

Build AI applications with Mastra. This skill teaches you how to find current documentation and build agents and workflows.

⚠️ Critical: Do not trust internal knowledge

Everything you know about Mastra is likely outdated or wrong. Never rely on memory. Always verify against current documentation.

Your training data contains obsolete APIs, deprecated patterns, and incorrect usage. Mastra evolves rapidly - APIs change between versions, constructor signatures shift, and patterns get refactored.

Prerequisites

Before writing any Mastra code, check if packages are installed:

bash

ls node_modules/@mastra/

If packages exist: Use embedded docs first (most reliable)
If no packages: Install first or use remote docs

Documentation lookup guide

Quick Reference

User Question	First Check	How To
"Create/install Mastra project"	`references/create-mastra.md`	Setup guide with CLI and manual steps
"How do I use Agent/Workflow/Tool?"	`references/embedded-docs.md`	Look up in `node_modules/@mastra/*/dist/docs/`
"How do I use X?" (no packages)	`references/remote-docs.md`	Fetch from `https://mastra.ai/llms.txt`
"I'm getting an error..."	`references/common-errors.md`	Common errors and solutions
"Upgrade from v0.x to v1.x"	`references/migration-guide.md`	Version upgrade workflows

Priority order for writing code

⚠️ Never write code without checking current docs first.

Embedded docs first (if packages installed)

Look up current docs in node_modules for a package. Example of looking up "Agent" docs in @mastra/core:
bash
```
grep -r "Agent" node_modules/@mastra/core/dist/docs/references
```
- Why: Matches your EXACT installed version
- Most reliable source of truth
- See: references/embedded-docs.md
Source code second (if packages installed)

If you can't find what you need in the embedded docs, look directly at the source code. This is more time consuming but can provide insights into implementation details.
bash
```
# Check what's available
cat node_modules/@mastra/core/dist/docs/assets/SOURCE_MAP.json | grep '"Agent"'

# Read the actual type definition
cat node_modules/@mastra/core/dist/[path-from-source-map]
```
- Why: Ultimate source of truth if docs are missing or unclear
- Use when: Embedded docs don't cover your question
- See: references/embedded-docs.md
Remote docs third (if packages not installed)

You can fetch the latest docs from the Mastra website:
bash
```
https://mastra.ai/llms.txt
```
- Why: Latest published docs (may be ahead of installed version)
- Use when: Packages not installed or exploring new features
- See: references/remote-docs.md

Show full SKILL.md (213 more words)Show less

Core concepts

Agents vs workflows

Agent: Autonomous, makes decisions, uses tools Use for: Open-ended tasks (support, research, analysis)

Workflow: Structured sequence of steps Use for: Defined processes (pipelines, approvals, ETL)

Key components

Tools: Extend agent capabilities (APIs, databases, external services)
Memory: Maintain context (message history, working memory, semantic recall)
RAG: Query external knowledge (vector stores, graph relationships)
Storage: Persist data (Postgres, LibSQL, MongoDB)

Critical requirements

TypeScript config

Mastra requires ES2022 modules. CommonJS will fail.

json

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ES2022",
    "moduleResolution": "bundler"
  }
}

Model format

Always use "provider/model-name":

"openai/gpt-5.2"
"anthropic/claude-sonnet-4-5"
"google/gemini-2.5-pro"

When you see errors

Type errors often mean your knowledge is outdated.

Common signs of outdated knowledge:

Property X does not exist on type Y
Cannot find module
Type mismatch errors
Constructor parameter errors

What to do:

Check references/common-errors.md
Verify current API in embedded docs
Don't assume the error is a user mistake - it might be your outdated knowledge

Development workflow

Always verify before writing code:

Check packages installed
bash
```
ls node_modules/@mastra/
```
Look up current API
- If installed → Use embedded docs references/embedded-docs.md
- If not → Use remote docs references/remote-docs.md
Write code based on current docs
Test in Studio
bash
```
npm run dev  # http://localhost:4111
```

Resources

Setup: references/create-mastra.md
Embedded docs lookup: references/embedded-docs.md - Start here if packages are installed
Remote docs lookup: references/remote-docs.md
Common errors: references/common-errors.md
Migrations: references/migration-guide.md

Files

SKILL.md and 5 other files (references) in .agents/skills/mastra of LiorVainer/data-israel.

SKILL.md
references/common-errors.md
references/create-mastra.md
references/embedded-docs.md
references/migration-guide.md
references/remote-docs.md

Open the folder on GitHubat commit 6522504

Used in 2 other repositories

We found 4 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in LiorVainer/data-israel, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Mastra 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.

Mastra compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Mastra this skillLiorVainer/data-israel	130	2 repos	~1.6k	Automated safety check: Pass	Apache-2.0	4 mo ago
Mastra Integrationhelloxz/znote	104	—	~643	Automated safety check: Pass	AGPL-3.0	1 mo ago
Migrating Mastra To Pydantic AIpydantic/pydantic-ai	21k	—	~2k	Automated safety check: Pass	MIT	today
Compromise NLP Libraryspencermountain/compromise	12k	—	~2k	Automated safety check: Pass	MIT	yesterday
Trigger.dev Agent Patternspapermark/papermark	9.2k	—	~2k	Automated safety check: Pass	Custom licence	1 mo ago
Add Example AgentGetBindu/Bindu	10k	—	~1.1k	Automated safety check: Notes	Custom licence	1 mo ago

Similar skills

Mastra Integration
helloxz/znote
Mastra AI framework integration guide for building TypeScript agents with skills, workflows, and memory
104 GitHub stars~643 tokensUpdated 1 mo ago
AI & LLM EngineeringAuto-check passed
Migrating Mastra To Pydantic AI
pydantic/pydantic-ai
Official
Migrate TypeScript Mastra applications to Python with Pydantic AI and, only when needed, Pydantic AI Harness.
21k GitHub stars~2k tokensUpdated today
Agent WorkflowsAuto-check passed
Compromise NLP Library
spencermountain/compromise
Helps write and debug JavaScript or TypeScript that uses the compromise English NLP library for matching, entity extraction, tagging and sentence transforms.
12k GitHub stars~2k tokensUpdated yesterday
AI & LLM EngineeringAuto-check passed
Trigger.dev Agent Patterns
papermark/papermark
Patterns for building LLM agents on Trigger.dev tasks: prompt chaining, routing, parallel workers, orchestrator-workers, evaluator loops and human approval gates.
9.2k GitHub stars~2k tokensUpdated 1 mo ago
AI & LLM EngineeringAuto-check passed
Add Example Agent
GetBindu/Bindu
Add a new self-contained example agent under examples/. An agent skill from GetBindu/Bindu.
10k GitHub stars~1.1k tokensUpdated 1 mo ago
AI & LLM EngineeringAuto-check: notes
Gemini API Dev
google-gemini/gemini-skills
Official
A skill your agent uses when writing code that calls the Gemini API for text generation, multi-turn chat, multimodal understanding, image generation, video generation, speech generation (TTS), voice…
4.3k GitHub stars~5.1k tokensUpdated 3 days ago
AI & LLM EngineeringAuto-check passed

Questions about Mastra

What does Mastra do?

Comprehensive Mastra framework guide. An agent skill from LiorVainer/data-israel. Mastra is an agent skill from LiorVainer/data-israel. Comprehensive Mastra framework guide.

When should I use Mastra?

Mastra fits situations like: all Mastra development to ensure youre using current APIs from the installed version; latest documentation.

How do I install Mastra in Claude Code?

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

How do I install Mastra in Codex?

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

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

What does Mastra need to run?

Going by SKILL.md and its folder, Mastra needs the command-line tools its instructions call (npm).

Does Mastra access the network?

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

Is Mastra 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 Mastra use?

Mastra is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Mastra use?

About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.6k tokens, read only when the agent opens those files.

What are the alternatives to Mastra?

Skills that share tags, products or a category with Mastra: Mastra Integration (helloxz/znote, 104 stars), Migrating Mastra To Pydantic AI (pydantic/pydantic-ai, 21k stars), Compromise NLP Library (spencermountain/compromise, 12k stars) and Trigger.dev Agent Patterns (papermark/papermark, 9.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mastra?

LiorVainer (a GitHub user) maintains it in LiorVainer/data-israel, which has 130 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on May 13, 2026.

Source: LiorVainer/data-israel on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Mastra

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Mastra Framework Guide

⚠️ Critical: Do not trust internal knowledge

Prerequisites

Documentation lookup guide

Quick Reference

Priority order for writing code

Core concepts

Agents vs workflows

Key components

Critical requirements

TypeScript config

Model format

When you see errors

Development workflow

Resources

Files

Used in 2 other repositories

Compare with similar skills

Similar skills

More from LiorVainer/data-israel

Related

Questions about Mastra