Agent skill

Mz Benchmark

by MaterializeInc in MaterializeInc/materialize

Add/modify/debug Materialize perf benchmark scenarios. An agent skill from MaterializeInc/materialize.

Custom licenceAuto-check passedDatabases

Install Mz Benchmark

skills CLI
$ npx skills add MaterializeInc/materialize --skill mz-benchmark -a claude-code

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

GitHub CLI
$ gh skill install MaterializeInc/materialize mz-benchmark --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/MaterializeInc/materialize.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/mz-benchmark .claude/skills/mz-benchmark && 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
mz-benchmark
GitHub stars
6.4k
Token cost
~2.8k tokens
SKILL.md length
621 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
Custom licence

At a glance

Add/modify/debug Materialize perf benchmark scenarios. An agent skill from MaterializeInc/materialize.

  • Works in 3 steps: Feature Benchmark (Micro-benchmarks) → Scalability Test (SQL Throughput Under… → Parallel Benchmark (Sustained Performance)
  • Tasks that involve SQL
  • SKILL.md covers Decision Guide, 1. Feature Benchmark…, 2. Scalability Test (SQL… and 3. Parallel Benchmark…
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Mz Benchmark is an agent skill from MaterializeInc/materialize. Add/modify/debug Materialize perf benchmark scenarios. Three frameworks: Feature Benchmark (single-op micro), Scalability Test (SQL throughput under concurrency), Parallel Benchmark (sustained latency via scenarios.py). Trigger: "benchmark", "feature benchmark", "scalability test", "parallel benchmark", "performance regression", "micro-benchmark", "TPS", "latency test", or edits in featurebenchmark/scenarios/, scalability/workload/workloads/, parallelbenchmark/scenarios.py. Note: measurement, not panic-stress…

Its SKILL.md is about 2.8k 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 Databases, covering SQL. It works with SQL, Apache Kafka and PostgreSQL. The repository describes itself as: The live data layer for apps and AI agents. Create up-to-the-second views into your business, just using SQL.

When your agent uses it

  • Tasks that involve SQL

Example prompts

  • “benchmark”
  • “feature benchmark”
  • “scalability test”
  • “/mz-benchmark”

Requirements

  • Python 3
  • Docker

Workflow steps

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

  1. Feature Benchmark (Micro-benchmarks)
  2. Scalability Test (SQL Throughput Under Concurrency)
  3. Parallel Benchmark (Sustained Performance)

What it can do on your machine

Read from SKILL.md and the folder at commit 80f0437. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are python and bash).

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

  • Network

    No URLs in SKILL.md.

    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

Mz Benchmark loads about 2.8k tokens when it runs. Until then it costs about 139 tokens; SKILL.md has 621 words of instructions outside code blocks.

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

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 621 words (~2,833 tokens).

“Materialize has some benchmark frameworks targetting local Docker, each suited to different performance concerns. Choose the right one based on what you're measuring.”

— opening of SKILL.md by MaterializeInc, Custom licence
name
mz-benchmark

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/mz-benchmark of MaterializeInc/materialize.

Open the folder on GitHubat commit 80f0437

Compare with similar skills

Mz Benchmark 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.

Mz Benchmark compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mz Benchmark this skillMaterializeInc/materialize6.4k—~2.8kAutomated safety check: PassCustom licence
SQL Database Support for pRESTprest/prest4.6k—~1.6kAutomated safety check: PassMIT
Chdb SQLvemetric/vemetric3941 repos~1.2kAutomated safety check: PassApache-2.0
Schema Explorationtimescale/pg-aiguide1.9k—~1.1kAutomated safety check: PassApache-2.0
Dingtalk AitableDingTalk-Real-AI/dingtalk-workspace-cli3.2k—~5.4kAutomated safety check: PassApache-2.0
Sql2erystemsrx/sql_to_ER188—~1.1kAutomated safety check: PassAGPL-3.0

Similar skills

  • Guides classifying, gap-analyzing and scaffolding support for a new SQL database in pREST, from Postgres-compatible variants to entirely new dialects.

    4.6k GitHub stars~1.6k tokensUpdated yesterday
    DatabasesAuto-check passed
  • Chdb SQL

    vemetric/vemetric

    A skill your agent uses when the user wants to run SQL — especially analytical SQL — on local files (parquet/csv/json), URLs, S3 paths, or remote databases (Postgres, MySQL, MongoDB, ClickHouse…

    394 GitHub starsUsed in 1 repo~1.2k tokens
    DatabasesAuto-check passed
  • Schema Exploration

    timescale/pg-aiguide

    Explore an existing PostgreSQL database before answering questions about its data or writing SQL.

    1.9k GitHub stars~1.1k tokensUpdated 5 days ago
    DatabasesAuto-check passed
  • Dingtalk Aitable

    DingTalk-Real-AI/dingtalk-workspace-cli

    钉钉 AI 表格(多维表)业务操作。Use when 用户需要操作 AI 表格/多维表/Base/Table、应用模式/App 页面/Widget、建表、查写记录、字段、记录评论、评论回复、访问密钥(API Key)、SQL/PostgreSQL/SELECT/JOIN、筛选、排序、公式、模板、批量导入 CSV 或 JSON、导出、仪表盘、图表、上传附件、数据源配置与同步、按任务 ID…

    3.2k GitHub stars~5.4k tokensUpdated 2 days ago
    DatabasesAuto-check passed
  • Sql2er

    ystemsrx/sql_to_ER

    A skill your agent uses when the user wants a Chen-model ER diagram from SQL CREATE TABLE statements or DBML, wants to rearrange or clean up an existing sql2er state, wants a skeleton-only overview…

    188 GitHub stars~1.1k tokensUpdated 6 days ago
    DatabasesAuto-check passed
  • PostgreSQL Documentation Reference

    2025Emma/vibe-coding-cn

    PostgreSQL database documentation - SQL queries, database design, administration, performance tuning, and advanced features. Use when working with PostgreSQL…

    23k GitHub starsUsed in 1 repo~19k tokens
    DatabasesAuto-check passed

More from MaterializeInc/materialize

All 15 skills in this repo
  • Mz Release Signoff

    MaterializeInc/materialize

    Verify a release candidate on the Grafana dashboards and sign off in release.

    6.4k GitHub stars~7.2k tokensUpdated today
    Auto-check passed
  • Mz Commit

    MaterializeInc/materialize

    Trigger: "commit", "prepare commit", "create PR", "push", "open pull request", or mentions committing, pre-commit checks, pull requests in Materialize.

    6.4k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Mz Dbt Release

    MaterializeInc/materialize

    Cut a dbt-materialize PyPI release: bump the version in version.py and setup.py, date the Unreleased CHANGELOG entry, and open the release PR with a Ship: <url body.

    6.4k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Mz Debug CI

    MaterializeInc/materialize

    Investigate CI failures on PR via gh + Buildkite MCP or bk CLI.

    6.4k GitHub stars~3.9k tokensUpdated today
    Auto-check passed
  • Mz Limits Test

    MaterializeInc/materialize

    Add/modify/debug limits test. An agent skill from MaterializeInc/materialize.

    6.4k GitHub stars~808 tokensUpdated today
    Auto-check passed
  • Mz Parallel Workload

    MaterializeInc/materialize

    Extend parallel-workload stress framework: random SQL concurrently to catch panics + unexpected errors (not perf — see mz-benchmark).

    6.4k GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Categories

Questions about Mz Benchmark

What does Mz Benchmark do?

Add/modify/debug Materialize perf benchmark scenarios. An agent skill from MaterializeInc/materialize. Mz Benchmark is an agent skill from MaterializeInc/materialize. Add/modify/debug Materialize perf benchmark scenarios.

When should I use Mz Benchmark?

Mz Benchmark fits situations like: tasks that involve SQL.

How do I install Mz Benchmark in Claude Code?

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

How do I install Mz Benchmark in Codex?

Run `npx skills add MaterializeInc/materialize --skill mz-benchmark -a codex`. Or copy the skill folder (.agents/skills/mz-benchmark in MaterializeInc/materialize) into .agents/skills/mz-benchmark in your project. Codex loads it when a task matches its description.

Can I use Mz Benchmark 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 MaterializeInc/materialize --skill mz-benchmark -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mz-benchmark, .gemini/skills/mz-benchmark, .github/skills/mz-benchmark and .opencode/skills/mz-benchmark in your project.

What does Mz Benchmark need to run?

SKILL.md names no scripts, command-line tools or credentials: Mz Benchmark is instructions for the agent only. Our summary lists: Python 3; Docker.

Does Mz Benchmark access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Mz Benchmark 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 Mz Benchmark use?

Mz Benchmark 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 Mz Benchmark use?

About 2.8k tokens (SKILL.md is roughly 11k 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 Mz Benchmark?

Skills that share tags, products or a category with Mz Benchmark: SQL Database Support for pREST (prest/prest, 4.6k stars), Chdb SQL (vemetric/vemetric, 394 stars), Schema Exploration (timescale/pg-aiguide, 1.9k stars) and Dingtalk Aitable (DingTalk-Real-AI/dingtalk-workspace-cli, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mz Benchmark?

MaterializeInc (a GitHub organization) maintains it in MaterializeInc/materialize, which has 6,377 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 7, 2026.

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