Official agent skill

Mps Language Analysis

by JetBrains in JetBrains/MPS

Analyze an MPS language by name — discover concepts, properties, references, children, aspects (editor/constraints/behavior), and metadata.

OfficialApache-2.0Auto-check passed

Install Mps Language Analysis

skills CLI
$ npx skills add JetBrains/MPS --skill mps-language-analysis -a claude-code

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

GitHub CLI
$ gh skill install JetBrains/MPS mps-language-analysis --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-language-analysis .claude/skills/mps-language-analysis && 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-language-analysis
GitHub stars
1.7k
Token cost
~1.4k tokens
SKILL.md length
596 words
Files
4 (incl. scripts, references)
Skills in repo
40
Repo updated
First seen
Licence
Apache-2.0

At a glance

Analyze an MPS language by name — discover concepts, properties, references, children, aspects (editor/constraints/behavior), and metadata.

  • Works in 4 steps: Verify Language: call… → Retrieve Concepts: use… → Extract Data: the response includes → …
  • Investigating an unfamiliar language
  • SKILL.md covers Loading companion skills, Critical Directives, Analyzing a Language by Name and Inspecting Concept Aspects, plus 3 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Mps Language Analysis is an agent skill from JetBrains/MPS, published by the product's own GitHub organization. Analyze an MPS language by name — discover concepts, properties, references, children, aspects (editor/constraints/behavior), and metadata. Use when investigating an unfamiliar language, exploring concept structure, or finding sample nodes to use as templates for JSON blueprints.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `references/concept-details.md`, `references/search-concepts.md` and `scripts/concept_shape.py`).

It works with JetBrains IDEs and Model Context Protocol. The repository describes itself as: JetBrains Meta programming System. The licence is Apache-2.0.

When your agent uses it

  • Investigating an unfamiliar language
  • Exploring concept structure
  • Finding sample nodes to use as templates for JSON blueprints

Example prompts

  • “/mps-language-analysis”

Requirements

  • Python 3

Workflow steps

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

  1. Verify Language: call mps_mcp_get_project_structure with the language name as a filter (startingPoint: My_Language). This confirms…
  2. Retrieve Concepts: use mps_mcp_get_concept_details with the language name in languageRefs. Both conceptRefs and languageRefs accept either…
  3. Extract Data: the response includes
  4. Drill Down

What it can do on your machine

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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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 Language Analysis loads about 1.4k tokens when it runs, and up to ~6.4k if it reads all its reference files. Until then it costs about 76 tokens; SKILL.md has 596 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from JetBrains/MPS at commit a92f944, republished under its Apache-2.0 licence (© JetBrains). 596 words, ~1,423 tokens.

Download SKILL.mdSave it as .claude/skills/mps-language-analysis/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
mps-language-analysis
description
Analyze an MPS language by name — discover concepts, properties, references, children, aspects (editor/constraints/behavior), and metadata. Use when investigating an unfamiliar language, exploring concept structure, or finding sample nodes to use as templates for JSON blueprints.
type
reference

MPS Language Analysis

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.

Workflow for inspecting an MPS language from a name (e.g. jetbrains.mps.lang.core). Returns concepts, metadata, structural info, and pointers to declarations and sample nodes.

Critical Directives

  • Use the fully qualified language name (e.g. jetbrains.mps.lang.core) — single-letter shorthand (j.m.l.core) requires resolution first via mps_mcp_get_project_structure.
  • For the qualifiedName returned by mps_mcp_get_concept_details, use it as the concept field in JSON blueprints. It is unambiguous.

Analyzing a Language by Name

  1. Verify Language: call mps_mcp_get_project_structure with the language name as a filter (startingPoint: My_Language). This confirms existence and provides the UUID.
  2. Retrieve Concepts: use mps_mcp_get_concept_details with the language name in languageRefs. Both conceptRefs and languageRefs accept either one value or a JSON array (real or written as a string); omit the unused selector.
  3. Extract Data: the response includes:
    • Name: concept FQN.
    • Description: found in shortDescription.
    • Metadata: isRootable, isAbstract, and the conceptReference ID.
    • Structure: properties, children, and references are detailed here.
  4. Drill Down:
    • Declaration: use the sourceNode reference with mps_mcp_open_node to open the definition.
    • Examples: use mps_mcp_query_nodes with FIND_INSTANCES (sampleOnly: true) to get a sample node. Then use mps_mcp_print_node to see its canonical JSON structure for use as a template.
    • Inheritance: load the mps-language-inheritance skill for deeper hierarchy analysis.

Inspecting Concept Aspects

Use mps_mcp_query_structure with LIST_CONCEPT_ASPECTS to find associated definitions (Editor, Constraints, Behavior):

  • Direct Aspects: returns roots targeting the specific concept.
  • Inherited Aspects: set includeInherited: true to include aspects from ancestors (superconcepts/interfaces).
  • Editor Analysis:
    • ConceptEditorDeclaration: defines the full editor for the targetsConcept.
    • EditorComponentDeclaration: defines reusable presentation pieces.
    • Check the editor model in the response to identify available editors.
Show full SKILL.md (236 more words)Show less
  • mps-language-inheritance — load when you need extended-language / superconcept / subconcept analysis.
  • mps-aspect-structure-concepts — load when defining or modifying concepts (not just reading them).
  • mps-language-aspects-overview — overview of which aspects exist and what each owns.

Reference Index

  • Open references/search-concepts.md for the mps_mcp_search_concepts matching algorithm — haystack composition, subtoken splitting, fallback ranking, the three scopes (modelReference / scope) and the auto-widen, the detail projections, the 50-match cap, and the sub-2-char failure mode.
  • Open references/concept-details.md for the mps_mcp_get_concept_details result schema and the unresolved-ref policy (all-failed vs partial-success envelopes and the suggestion heuristic).

Scripts

scripts/concept_shape.py — reduces a mps_mcp_get_concept_details result file to one line per property, reference, and child role (type, enum literals, cardinality): the concept shape needed to author a blueprint, instead of the 10–40 KB details file.

python3 scripts/concept_shape.py /var/folders/.../mps-node-456.json --concept Course
Course  com.example.courses.structure.Course  rootable
  prop   credits        integer
  prop   level          enum Level [INTRO|CORE|ADVANCED]
  child  lessons        com.example.courses.structure.Lesson     1..n
  child  prerequisites  com.example.courses.structure.CourseRef  0..n

--all keeps the inherited shortDescription / virtualPackage / smodelAttribute features that are hidden by default; --list-tools prints the tools and parameters it depends on. The script is a thin front end over scripts/mps_dump.py in the mps-mcp-workflow skill root after loading that companion skill from the same origin, which must be installed alongside this one; that library also offers the roots, node, and count projections.

No python3 (typically Windows): read the details file with the file reader and keep, per concept, only qualifiedName, isAbstract/isRootable, and for each entry of properties / references / children the name, type/targetConcept, cardinality, and enumerationValues (plus enumerationDefault, the literal a property holding the default value carries) — ignore featureId, sourceNode, doc, and sampleNode unless you need them.

© 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 3 other files (scripts, references) in .agents/skills/mps-language-analysis of JetBrains/MPS.

  • SKILL.md
  • references/concept-details.md
  • references/search-concepts.md
  • scripts/concept_shape.py

Open the folder on GitHubat commit a92f944

Compare with similar skills

Mps Language Analysis 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 Language Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mps Language Analysis this skillJetBrains/MPS1.7k—~1.4kAutomated safety check: PassApache-2.0
Claude Docs Consultantcentminmod/my-claude-code-setup2.7k—~959Automated safety check: PassMIT
Spock AdbWahdanZ/SpockAdb114—~3.3kAutomated safety check: PassApache-2.0
Amplicode InstallAmplicode/spring-skills126—~2.6kAutomated safety check: PassNone
Idea MCPdtprj/dongting208—~698Automated safety check: PassApache-2.0
Spring Data JpaAmplicode/spring-skills126—~838Automated safety check: PassNone

Similar skills

  • Claude Docs Consultant

    centminmod/my-claude-code-setup

    Consult official Claude Code documentation from code.claude.com using selective fetching.

    2.7k GitHub stars~959 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Spock Adb

    WahdanZ/SpockAdb

    Debug Android apps on a connected device or emulator through the Spock ADB MCP server (tools named android).

    114 GitHub stars~3.3k tokensUpdated 3 days ago
    MobileAuto-check passed
  • Amplicode Install

    Amplicode/spring-skills

    Installs the Amplicode IntelliJ plugin into IntelliJ IDEA (Ultimate/Community) and GigaIDE on the user's machine.

    126 GitHub stars~2.6k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Idea MCP

    dtprj/dongting

    IntelliJ IDEA MCP for Java code analysis, testing, refactoring, and project navigation.

    208 GitHub stars~698 tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Spring Data Jpa

    Amplicode/spring-skills

    Rules and guidelines for working with Spring Data JPA in the project.

    126 GitHub stars~838 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Spring Explore

    Amplicode/spring-skills

    Explores a Spring Boot application and builds primary context: tech stack, module structure, domain entities, REST endpoints.

    126 GitHub stars~4.1k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed

More from JetBrains/MPS

All 40 skills in this repo
  • 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~4.7k tokensUpdated yesterday
    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 yesterday
    Auto-check passed
  • Mps MCP Workflow

    JetBrains/MPS

    Official

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

    1.7k GitHub stars~5.8k tokensUpdated yesterday
    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 yesterday
    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 yesterday
    Auto-check passed
  • Official

    A skill your agent uses when bundling a new plain Java/Kotlin plugin into MPS distribution archives, debugging packaging/layout issues in build/mps.xml, tracing where per-plugin artefacts end up, or…

    1.7k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed

Questions about Mps Language Analysis

What does Mps Language Analysis do?

Analyze an MPS language by name — discover concepts, properties, references, children, aspects (editor/constraints/behavior), and metadata. Mps Language Analysis is an agent skill from JetBrains/MPS, published by the product's own GitHub organization. Analyze an MPS language by name — discover concepts, properties, references, children, aspects (editor/constraints/behavior), and metadata.

When should I use Mps Language Analysis?

Mps Language Analysis fits situations like: investigating an unfamiliar language; exploring concept structure; finding sample nodes to use as templates for JSON blueprints.

How do I install Mps Language Analysis in Claude Code?

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

How do I install Mps Language Analysis in Codex?

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

Can I use Mps Language Analysis 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-language-analysis -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-language-analysis, .gemini/skills/mps-language-analysis, .github/skills/mps-language-analysis and .opencode/skills/mps-language-analysis in your project.

What does Mps Language Analysis need to run?

Going by SKILL.md and its folder, Mps Language Analysis needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Mps Language Analysis 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 Language Analysis 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Mps Language Analysis use?

Mps Language Analysis 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 Language Analysis use?

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

What are the alternatives to Mps Language Analysis?

Skills that share tags, products or a category with Mps Language Analysis: Claude Docs Consultant (centminmod/my-claude-code-setup, 2.7k stars), Spock Adb (WahdanZ/SpockAdb, 114 stars), Amplicode Install (Amplicode/spring-skills, 126 stars) and Idea MCP (dtprj/dongting, 208 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mps Language Analysis?

JetBrains (a GitHub organization, an official publisher) maintains it in JetBrains/MPS, which has 1,660 GitHub stars. The repository holds 40 skills in this directory. The repository was last updated on October 7, 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.