Official agent skill

Mps Run Configurations

by JetBrains in JetBrains/MPS

Create and execute IDE run configurations for MPS root nodes via MPS MCP — Java Application for IMainClass / ClassConcept with main, JUnit Tests for ITestCase.

OfficialApache-2.0Auto-check passedTesting & QA

Install Mps Run Configurations

skills CLI
$ npx skills add JetBrains/MPS --skill mps-run-configurations -a claude-code

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

GitHub CLI
$ gh skill install JetBrains/MPS mps-run-configurations --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/JetBrains/MPS.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/mps-run-configurations .claude/skills/mps-run-configurations && 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
mps-run-configurations
GitHub stars
1.7k
Token cost
~1.5k tokens
SKILL.md length
728 words
Files
7 (incl. references)
Skills in repo
41
Repo updated
First seen
Licence
Apache-2.0

At a glance

Create and execute IDE run configurations for MPS root nodes via MPS MCP — Java Application for IMainClass / ClassConcept with main, JUnit Tests for ITestCase.

  • Works in 4 steps: mps_mcp_alter_nodes MAKE on the module… → mps_mcp_create_run_configuration on the… → execute_run_configuration (of MPS MCP,… → …
  • Launching DSL main-like roots
  • SKILL.md covers Loading companion skills, Critical Directives, Common Workflow and Related Skills, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Mps Run Configurations is an agent skill from JetBrains/MPS, published by the product's own GitHub organization. Create and execute IDE run configurations for MPS root nodes via MPS MCP — Java Application for IMainClass / ClassConcept with main, JUnit Tests for ITestCase. Use when launching DSL main-like roots, plain BaseLanguage ClassConcept mains, or MPS test cases from a node; reusing or replacing an existing run config; diagnosing ClassNotFoundException, compileInMPS=false, or "not runnable through this tool" failures.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `references/classconcept-and-fallbacks.md`, `references/common-failures.md` and `references/compile-before-run.md`).

It sits in Testing & QA, covering Unit testing and Test generation. It works with Model Context Protocol, JUnit and Java. The repository describes itself as: JetBrains Meta programming System. The licence is Apache-2.0.

When your agent uses it

  • Launching DSL main-like roots
  • Plain BaseLanguage ClassConcept mains
  • MPS test cases from a node
  • Replacing an existing run config

Example prompts

  • “not runnable through this tool”
  • “/mps-run-configurations”

Workflow steps

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

  1. mps_mcp_alter_nodes MAKE on the module of the DSL root, rebuild: true.
  2. mps_mcp_create_run_configuration on the DSL root with a stable configurationName (the generated class FQN is a good default for…
  3. execute_run_configuration (of MPS MCP, not IDEA's) by name with waitForExit: true and a generous timeout.
  4. On Could not find or load main class, step 1 didn't reach classes_gen — re-run it.

What it can do on your machine

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

    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

Mps Run Configurations loads about 1.5k tokens when it runs, and up to ~6.7k if it reads all its reference files. Until then it costs about 114 tokens; SKILL.md has 728 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~114
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.7k

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 JetBrains/MPS at commit 3e9cfcd, republished under its Apache-2.0 licence (© JetBrains). 728 words, ~1,484 tokens.

Download SKILL.mdSave it as .claude/skills/mps-run-configurations/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
mps-run-configurations
description
Create and execute IDE run configurations for MPS root nodes via MPS MCP — Java Application for `IMainClass` / `ClassConcept` with `main`, JUnit Tests for `ITestCase`. Use when launching DSL `main`-like roots, plain BaseLanguage `ClassConcept` mains, or MPS test cases from a node; reusing or replacing an existing run config; diagnosing `ClassNotFoundException`, `compileInMPS=false`, or "not runnable through this tool" failures.
type
reference

Running MPS Root Nodes

Loading companion skills

Companion names in this skill are lazy dependencies: load only those relevant to the current task. If this skill came from an MCP server, use the host's skill loader to resolve the companion's unique discovered entry URI on the same host-assigned originating server. If the host has no server-backed skill loader, stop and report that limitation; do not silently fall back to a filesystem copy. If this skill came from a filesystem catalog, load the named sibling from that same catalog at <skills-root>/<skill-name>/SKILL.md, even if remote skill loaders are also available. Do not invent a tool name or server endpoint.

This skill covers the path from "an MPS root node exists in a model" to "a green IDE run / red stack trace in my hand," using only MCP tools. It targets user-level artifacts (DSL main-like roots, plain ClassConcept mains, test cases) — not launching MPS itself (the MPS / MPS (2nd inst.) configs are a different topic, see AGENTS.md or CLAUDE.md).

Critical Directives

  • execute_run_configuration and get_run_configurations are provided both by MPS and IDEA. Use the ones provided by MPS for running MPS nodes/tests.
  • mps_mcp_create_run_configuration accepts a root, an array of test roots, a model, or an array of models. A single root is still one of three shapes: implements IMainClass, implements ITestCase, or is a ClassConcept with a qualifying static main. One model alone stays a live JUnit config; any other set is a snapshot of the test roots present at creation. A model reference passed as nodeReference is rejected — pass it in modelReference. See references/create-and-execute.md.
  • MAKE the module, not just the model, before running. Model MAKE regenerates source_gen but does not always compile into classes_gen; running launches bytecode, so a stale classes_gen silently runs old code. See references/compile-before-run.md.
  • Keep configurationName stable across iterations. The tool replaces the existing config of the same <type>.<name> rather than creating duplicates — idempotent setup is the goal. Use distinct names only when you actually want parallel configs.
  • Do not silently flip compileInMPS=false to true. Compile.None and JPS-compile settings are usually intentional (sandbox modules, externally-built modules, packaged libraries). Confirm with the user; otherwise take the IDEA MCP file-path fallback.
  • Prefer the source-root path over generated-Java entry points. Source-root configs survive regeneration; file-path configs against source_gen only work while classes_gen is fresh.
  • MPS MCP execute_run_configuration / get_run_configurations do not surface run points under source_gen. Use the IDEA MCP variants when you need a filePath+line launcher for generated Java.
  • Reuse before you create. If the user already has a working run config, prefer get_run_configurations() + execute_run_configuration by its existing name — duplicates are pointless.
Show full SKILL.md (299 more words)Show less

Common Workflow

End-to-end pattern for "I changed a DSL root, run it":

  1. mps_mcp_alter_nodes MAKE on the module of the DSL root, rebuild: true.
  2. mps_mcp_create_run_configuration on the DSL root with a stable configurationName (the generated class FQN is a good default for IMainClass; leave blank for ClassConcept to match the IDE gutter's Class <ClassName> default).
  3. execute_run_configuration (of MPS MCP, not IDEA's) by name with waitForExit: true and a generous timeout.
  4. On Could not find or load main class, step 1 didn't reach classes_gen — re-run it.

Keep the configuration name stable across iterations so step 2 idempotently overwrites itself rather than littering the IDE with duplicates.

  • mps-baselanguage — when the runnable root is a plain ClassConcept you authored or need to inspect (main method shape, BaseLanguage editing).
  • mps-aspect-generator — when stale or wrong generated Java is the root cause of an execution failure.
  • bugfix-workflow — when an execution failure points back at the generator or model rather than the launcher.

Reference Index

  • Open references/runnable-shapes.md when you need to confirm whether a concept is launchable, look up the exact main predicate or compileInMPS gate, or interpret a "not runnable through this tool" / "compileInMPS=false" refusal.
  • Open references/create-and-execute.md when you need the exact mps_mcp_create_run_configuration / execute_run_configuration / get_run_configurations call shape, naming and replacement semantics, or the difference between MPS MCP and IDEA MCP variants.
  • Open references/classconcept-and-fallbacks.md when a ClassConcept run path doesn't fire — compileInMPS=false, missing main, ambiguous duplicates — and you need the IDEA MCP file-path fallback or the persisted-XML structure of the node-aware Java Application config.
  • Open references/compile-before-run.md when the run fails with ClassNotFoundException, you're deciding between module MAKE and model MAKE, or output disagrees with edited source.
  • Open references/decision-matrix.md for the at-a-glance situation→approach table covering every supported launch path.
  • Open references/common-failures.md for the symptom→cause→fix table covering every published error and its remediation.

© JetBrains, Apache-2.0. 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 6 other files (references) in .agents/skills/mps-run-configurations of JetBrains/MPS.

  • SKILL.md
  • references/classconcept-and-fallbacks.md
  • references/common-failures.md
  • references/compile-before-run.md
  • references/create-and-execute.md
  • references/decision-matrix.md
  • references/runnable-shapes.md

Open the folder on GitHubat commit 3e9cfcd

Compare with similar skills

Mps Run Configurations 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.

Mps Run Configurations compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mps Run Configurations this skillJetBrains/MPS1.7k—~1.5kAutomated safety check: PassApache-2.0
Eclipse Testgradusnikov/eclipse-chatgpt-plugin172—~1kAutomated safety check: PassMIT
TDD GuideLeoYeAI/openclaw-master-skills2.2k—~1.4kAutomated safety check: PassMIT
Java Regression Test GeneratorArabelaTso/Skills-4-SE253—~4kAutomated safety check: PassApache-2.0
Mocking Test GeneratorArabelaTso/Skills-4-SE253—~1.6kAutomated safety check: PassApache-2.0
Test Oracle GeneratorArabelaTso/Skills-4-SE253—~3.5kAutomated safety check: PassApache-2.0

Similar skills

  • Eclipse Test

    gradusnikov/eclipse-chatgpt-plugin

    Run JUnit tests in Eclipse projects — all tests, by package, by class, or individual test methods.

    172 GitHub stars~1k tokensUpdated 2 days ago
    Testing & QAAuto-check passed
  • TDD Guide

    LeoYeAI/openclaw-master-skills

    Test-driven development skill for writing unit tests, generating test fixtures and mocks, analyzing coverage gaps, and guiding red-green-refactor workflows across Jest, Pytest, JUnit, Vitest, and…

    2.2k GitHub stars~1.4k tokensUpdated 2 mo ago
    Testing & QAAuto-check passed
  • Java Regression Test Generator

    ArabelaTso/Skills-4-SE

    Automatically generate regression tests for Java codebases by analyzing changes between old and new code versions.

    253 GitHub stars~4k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed
  • Mocking Test Generator

    ArabelaTso/Skills-4-SE

    Generate unit tests with proper mocking for Python (unittest.mock/pytest) or Java (Mockito/JUnit) code.

    253 GitHub stars~1.6k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed
  • Test Oracle Generator

    ArabelaTso/Skills-4-SE

    Generates automated test oracles to verify correct software behavior.

    253 GitHub stars~3.5k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed
  • Unit Test Parameterized

    giuseppe-trisciuoglio/developer-kit

    Provides parameterized testing patterns with JUnit 5, generates data-driven unit tests using @ParameterizedTest, @ValueSource, @CsvSource, @MethodSource.

    357 GitHub stars~1.6k tokensUpdated 1 mo ago
    Testing & QAAuto-check: notes

More from JetBrains/MPS

All 41 skills in this repo
  • Official

    Analyze an MPS language by name — discover concepts, properties, references, children, aspects (editor/constraints/behavior), metadata, and answer type questions (is A a subtype of B, common…

    1.7k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Mps Node Editing

    JetBrains/MPS

    Official

    Add, update, or delete MPS nodes using JSON blueprints — covers the unified blueprint format, staged construction for large subtrees, validation, and reference repair.

    1.7k GitHub stars~5.1k tokensUpdated today
    Auto-check passed
  • Official

    Open an MPS project in a running or freshly started MPS instance when MCP tools fail because no project is open (welcome screen), close an open project with mpsmcpcloseproject, or create a new empty…

    1.7k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Mps MCP Workflow

    JetBrains/MPS

    Official

    Complete JetBrains MPS workflow guide for DSL projects — models, languages, generators, node JSON blueprints, type queries, validation, MPS MCP tool usage, and the index of companion skills.

    1.7k GitHub stars~6.6k tokensUpdated today
    Auto-check passed
  • Bugfix Workflow

    JetBrains/MPS

    Official

    Structured MPS bugfix workflow driven by a YouTrack issue ID — preflight tool checks, version/branch derivation, parallel-agent problem analysis, solution design, branch creation, implementation…

    1.7k GitHub stars~4.4k tokensUpdated today
    Auto-check passed
  • Official

    Define concepts, interface concepts, enumerations, and constrained data types in an MPS language's structure aspect.

    1.7k GitHub stars~2.8k tokensUpdated today
    Auto-check passed

Questions about Mps Run Configurations

What does Mps Run Configurations do?

Create and execute IDE run configurations for MPS root nodes via MPS MCP — Java Application for IMainClass / ClassConcept with main, JUnit Tests for ITestCase. Mps Run Configurations is an agent skill from JetBrains/MPS, published by the product's own GitHub organization. Create and execute IDE run configurations for MPS root nodes via MPS MCP — Java Application for IMainClass / ClassConcept with main, JUnit Tests for ITestCase.

When should I use Mps Run Configurations?

Mps Run Configurations fits situations like: launching DSL main-like roots; plain BaseLanguage ClassConcept mains; MPS test cases from a node; replacing an existing run config.

How do I install Mps Run Configurations in Claude Code?

Run `npx skills add JetBrains/MPS --skill mps-run-configurations -a claude-code`. Or copy the skill folder (.agents/skills/mps-run-configurations in JetBrains/MPS) into .claude/skills/mps-run-configurations in your project. Claude Code loads it when a task matches its description.

How do I install Mps Run Configurations in Codex?

Run `npx skills add JetBrains/MPS --skill mps-run-configurations -a codex`. Or copy the skill folder (.agents/skills/mps-run-configurations in JetBrains/MPS) into .agents/skills/mps-run-configurations in your project. Codex loads it when a task matches its description.

Can I use Mps Run Configurations 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 JetBrains/MPS --skill mps-run-configurations -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mps-run-configurations, .gemini/skills/mps-run-configurations, .github/skills/mps-run-configurations and .opencode/skills/mps-run-configurations in your project.

What does Mps Run Configurations need to run?

SKILL.md names no scripts, command-line tools or credentials: Mps Run Configurations is instructions for the agent only.

Does Mps Run Configurations 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 Mps Run Configurations 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 Mps Run Configurations use?

Mps Run Configurations is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Mps Run Configurations use?

About 1.5k tokens (SKILL.md is roughly 5.9k 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 5.2k tokens, read only when the agent opens those files.

What are the alternatives to Mps Run Configurations?

Skills that share tags, products or a category with Mps Run Configurations: Eclipse Test (gradusnikov/eclipse-chatgpt-plugin, 172 stars), TDD Guide (LeoYeAI/openclaw-master-skills, 2.2k stars), Java Regression Test Generator (ArabelaTso/Skills-4-SE, 253 stars) and Mocking Test Generator (ArabelaTso/Skills-4-SE, 253 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mps Run Configurations?

JetBrains (a GitHub organization, an official publisher) maintains it in JetBrains/MPS, which has 1,661 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on October 9, 2026.

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