Agent skill

Mui Release

by mui in mui/mui-public

Run or assist a release in any MUI repo, at any stage - release PR, npm publish, docs deploy, GitHub release.

MITAuto-check passedFrontend & Design

Install Mui Release

skills CLI
$ npx skills add mui/mui-public --skill mui-release -a claude-code

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

GitHub CLI
$ gh skill install mui/mui-public mui-release --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/mui/mui-public.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mui-release .claude/skills/mui-release && 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
mui-release
GitHub stars
106
Token cost
~749 tokens
SKILL.md length
227 words
Files
5
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

Run or assist a release in any MUI repo, at any stage - release PR, npm publish, docs deploy, GitHub release.

  • Tasks that involve Design systems
  • Calls gh, npm and curl

What it does

Mui Release is an agent skill from mui/mui-public. Run or assist a release in any MUI repo, at any stage - release PR, npm publish, docs deploy, GitHub release.

Its SKILL.md is about 750 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `stage-1-prepare-pr.md`, `stage-2-publish-packages.md` and `stage-3-publish-docs.md`).

It sits in Frontend & Design, covering Design systems. It works with npm and GitHub. The repository describes itself as: The public mono-repository of MUI (as an organization), see mui/mui-private for the opposite. The licence is MIT.

When your agent uses it

  • Tasks that involve Design systems

Example prompts

  • “/mui-release”

What it can do on your machine

Read from SKILL.md and the folder at commit 6229b33. 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
    • npm
    • curl

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

  • Network

    No URLs in SKILL.md. Its commands use gh, npm and curl, 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

Mui Release loads about 749 tokens when it runs. Until then it costs about 30 tokens; SKILL.md has 227 words of instructions outside code blocks.

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

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 mui/mui-public at commit 6229b33, republished under its MIT licence (© mui). 227 words, ~749 tokens.

Download SKILL.mdSave it as .claude/skills/mui-release/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
mui-release
description
Run or assist a release in any MUI repo, at any stage - release PR, npm publish, docs deploy, GitHub release.
argument-hint
[target-version]

MUI Release

Every MUI repo releases through the same staged pipeline. Each stage depends on the previous one completing — never start a stage before its predecessor is done. This skill describes the shared skeleton; the details vary per repo.

Resumable: the skill can be invoked at any stage — a release often spans multiple sessions (e.g. the PR was created and merged earlier, and the user now wants to trigger the npm publish). In the pipeline diagram below, each arrow out of a stage states the observable evidence that the stage is complete: resume at the first stage whose evidence is missing. Confirm the detected stage with the user before continuing; earlier stages' outputs are inputs, not work to redo.

Source of truth: the target repo's scripts/README.md is the authoritative, evolving runbook. Always read it in the target checkout before releasing; use this skill to know what the stages mean and what to expect. Where the README contradicts this skill, the README wins. Repo-specific steps (docs release pages, hotfix flows, prerelease progressions, docs-only deploys, first-time package publishing) live only there. Repos without that runbook: read their release workflow directly.

The pipeline

Each stage's instructions live in its own file — after detecting and confirming the current stage, read that stage's file:

mermaid
flowchart TD
    S1["Stage 1: Prepare the release PR\n(stage-1-prepare-pr.md)"]
    S2["Stage 2: Merge the PR, then publish\n(stage-2-publish-packages.md)"]
    S3["Stage 3: Publish the docs\n(stage-3-publish-docs.md)"]
    S4["Stage 4: Publish the GitHub release, then announce\n(stage-4-github-release.md)"]

    S1 -- "open PR with the release label,\napproved, CI green" --> S2
    S2 -- "release PR merged, packages on npm at\nthe new version, draft GitHub release created" --> S3
    S3 -- "docs live for the new version" --> S4
    S4 -- "published non-draft GitHub release for the\ncurrent root package.json version\n(release done, next one starts at Stage 1)" --> S1

Verify each stage's evidence with read-only commands (run in the target checkout; <version> is the root package.json version):

bash
# release PR: open (stage 1) or merged (stage 2 done merging)
gh pr list --label release --state open --json number,title,reviewDecision
gh pr list --label release --state merged --limit 1 --json number,title,mergedAt
gh pr checks <number>                      # CI green?

# packages on npm at the new version
npm view <main-package>@<version> version

# GitHub release: exists? still a draft?
gh release list --limit 5 --json tagName,isDraft,isLatest
gh release view "v<version>" --json tagName,isDraft

# docs live for the new version
curl -s <docs-url> | grep "<version>"      # or check the Netlify dashboard

© mui, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files in skills/mui-release of mui/mui-public.

  • SKILL.md
  • stage-1-prepare-pr.md
  • stage-2-publish-packages.md
  • stage-3-publish-docs.md
  • stage-4-github-release.md

Open the folder on GitHubat commit 6229b33

Compare with similar skills

Mui Release 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.

Mui Release compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mui Release this skillmui/mui-public106—~749Automated safety check: PassMIT
Scraps Reviewgetsentry/sentry45k—~1.2kAutomated safety check: NotesCustom licence
Run Umbraco UIumbraco/Umbraco.UI152—~1.2kAutomated safety check: PassMIT
Design SystemBuildGreatProducts/builder-os227—~4.8kAutomated safety check: PassMIT
Plugin InstallerIgorWarzocha/Opencode-Workflows122—~1.3kAutomated safety check: PassNone
Design Project Scaffoldplugin87/ux-ui-agent-skills1.5k—~1.1kAutomated safety check: PassMIT

Similar skills

  • Scraps Review

    getsentry/sentry

    Official

    Filter large Sentry Scraps design-system migration PRs for review by separating mechanical import-path changes, generated baseline updates, snapshot mocks, and pure renames from substantive…

    45k GitHub stars~1.2k tokensUpdated today
    Frontend & DesignAuto-check: notes
  • Run Umbraco UI

    umbraco/Umbraco.UI

    Build, run, and drive the Umbraco.UI (UUI) web-component library via its Storybook.

    152 GitHub stars~1.2k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Design System

    BuildGreatProducts/builder-os

    Translates an image (or a set of image references — screenshots, mockups, Figma URLs, live websites) into two mirrored design-system artifacts: docs/design.md (YAML tokens + prose, following…

    227 GitHub stars~4.8k tokensUpdated 3 mo ago
    Frontend & DesignAuto-check passed
  • Plugin Installer

    IgorWarzocha/Opencode-Workflows

    Find, install, and configure OpenCode plugins from the catalog or community.

    122 GitHub stars~1.3k tokensUpdated 8 mo ago
    Frontend & DesignAuto-check passed
  • Design Project Scaffold

    plugin87/ux-ui-agent-skills

    Creates a new design-product project from the kit's product-design template, then installs the engine folders and the Playwright dependency that the quality gates need.

    1.5k GitHub stars~1.1k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Shadcn Project Workflow

    muratgur/ordinus

    Work with shadcn/ui in Ordinus. An agent skill from muratgur/ordinus.

    109 GitHub stars~859 tokensUpdated 1 mo ago
    Frontend & DesignAuto-check passed

More from mui/mui-public

  • Mui Renovate Triage

    mui/mui-public

    Fetch a deterministic snapshot of open MUI Renovate PRs and review them one by one.

    106 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Mui Triage

    mui/mui-public

    Triage MUI GitHub issues from a mui/<repo/issues/<num URL or issue number - fetch context, classify state/type labels, prepare a durable summary comment, and emit a reviewable apply script without…

    106 GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • PR Review

    mui/mui-public

    Review the current diff for regressions, correctness bugs, tests, simplifications, and docs issues, scaling depth to a low/medium/high/xhigh/max effort level.

    106 GitHub stars~4.6k tokensUpdated today
    Auto-check passed
  • Mui Renovate Fix

    mui/mui-public

    Fix a Renovate dependency-update PR with the minimal compatible code adaptation, extracting a dependency bump from a grouped PR only when the fix requires the new version.

    106 GitHub stars~1.5k tokensUpdated today
    Auto-check passed

Works with

Questions about Mui Release

What does Mui Release do?

Run or assist a release in any MUI repo, at any stage - release PR, npm publish, docs deploy, GitHub release. Mui Release is an agent skill from mui/mui-public. Run or assist a release in any MUI repo, at any stage - release PR, npm publish, docs deploy, GitHub release.

When should I use Mui Release?

Mui Release fits situations like: tasks that involve Design systems.

How do I install Mui Release in Claude Code?

Run `npx skills add mui/mui-public --skill mui-release -a claude-code`. Or copy the skill folder (skills/mui-release in mui/mui-public) into .claude/skills/mui-release in your project. Claude Code loads it when a task matches its description.

How do I install Mui Release in Codex?

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

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

What does Mui Release need to run?

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

Does Mui Release access the network?

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

Is Mui Release 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 Mui Release use?

Mui Release is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Mui Release use?

About 749 tokens (SKILL.md is roughly 3k 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 Mui Release?

Skills that share tags, products or a category with Mui Release: Scraps Review (getsentry/sentry, 45k stars), Run Umbraco UI (umbraco/Umbraco.UI, 152 stars), Design System (BuildGreatProducts/builder-os, 227 stars) and Plugin Installer (IgorWarzocha/Opencode-Workflows, 122 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mui Release?

mui (a GitHub organization) maintains it in mui/mui-public, which has 106 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 7, 2026.

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