Official agent skill

Mps Aspect Generation Plan

by JetBrains in JetBrains/MPS

A skill your agent uses when defining or modifying an MPS generation plan — explicit ordering of generators, checkpoints for cross-model reference resolution, forks for parallel branches…

OfficialApache-2.0Auto-check passedDevelopment

Install Mps Aspect Generation Plan

skills CLI
$ npx skills add JetBrains/MPS --skill mps-aspect-generation-plan -a claude-code

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

GitHub CLI
$ gh skill install JetBrains/MPS mps-aspect-generation-plan --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-aspect-generation-plan .claude/skills/mps-aspect-generation-plan && 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-aspect-generation-plan
GitHub stars
1.7k
Token cost
~1.9k tokens
SKILL.md length
808 words
Files
12 (incl. references)
Skills in repo
41
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when defining or modifying an MPS generation plan — explicit ordering of generators, checkpoints for cross-model reference resolution, forks for parallel branches…

  • Works in 8 steps: Create a solution; add a model with… → Add used languages… → Create a Plan root node with a… → …
  • Modifying an MPS generation plan — explicit ordering of generators
  • SKILL.md covers Loading companion skills, When to use a generation plan, Critical Directives and Common-Path Workflow, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Mps Aspect Generation Plan is an agent skill from JetBrains/MPS, published by the product's own GitHub organization. Use when defining or modifying an MPS generation plan — explicit ordering of generators, checkpoints for cross-model reference resolution, forks for parallel branches, IncludePlan composition, conditional PlanContribution activation, ParameterEquals/ConceptListSelector fork selectors, and InitModelAttributes for targetFacet routing. Apply when working with @genplan models, the jetbrains.mps.lang.generator.plan language, attaching plans via DevKits or the Custom generation facet, or debugging cross-model mapping…

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including reference files (for example `references/aspect-model-stereotypes.md`, `references/authoring-checklist.md` and `references/checkpoints.md`).

It sits in Development. It works with JetBrains IDEs. The repository describes itself as: JetBrains Meta programming System. The licence is Apache-2.0.

When your agent uses it

  • Modifying an MPS generation plan — explicit ordering of generators
  • Checkpoints for cross-model reference resolution
  • Forks for parallel branches
  • IncludePlan composition

Example prompts

  • “/mps-aspect-generation-plan”

Workflow steps

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

  1. Create a solution; add a model with stereotype genplan (file like MyPlan@genplan.mps).
  2. Add used languages jetbrains.mps.lang.generator.plan and jetbrains.mps.lang.smodel.
  3. Create a Plan root node with a descriptive name.
  4. Add Transform steps in order (one per phase); group parallel-safe languages in one Transform with multiple LanguageEntry children.
  5. Insert Checkpoint steps wherever downstream generators must resolve cross-model references.
  6. Add Fork steps for any output variant requiring its own branch (e.g. XML alongside Java); or add a separate PlanContribution root for…
  7. Attach the plan to models via a DevKit (production) or the Custom generation facet (prototyping).
  8. Verify with MPS UI Show generation plan and mps_mcp_check_root_node_problems.

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 Aspect Generation Plan loads about 1.9k tokens when it runs, and up to ~10k if it reads all its reference files. Until then it costs about 140 tokens; SKILL.md has 808 words of instructions outside code blocks.

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

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). 808 words, ~1,905 tokens.

Download SKILL.mdSave it as .claude/skills/mps-aspect-generation-plan/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.
name
mps-aspect-generation-plan
description
Use when defining or modifying an MPS generation plan — explicit ordering of generators, checkpoints for cross-model reference resolution, forks for parallel branches, IncludePlan composition, conditional PlanContribution activation, ParameterEquals/ConceptListSelector fork selectors, and InitModelAttributes for targetFacet routing. Apply when working with @genplan models, the jetbrains.mps.lang.generator.plan language, attaching plans via DevKits or the Custom generation facet, or debugging cross-model mapping label resolution.
type
reference

MPS Generation Plans

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.

A generation plan (Plan) is an ordered script that controls which generators run, in what sequence, and with what synchronization points. Without a plan, MPS determines order from mutual generator priorities and dependencies. A plan lets language designers specify that ordering once, in a single place, without requiring all involved languages to know about each other.

Language: jetbrains.mps.lang.generator.plan (id 7ab1a6fa-0a11-4b95-9e48-75f363d6cb00, version 3) Also requires: jetbrains.mps.lang.smodel (for LanguageId / LanguageIdentity nodes)

When to use a generation plan

  • You need a guaranteed ordering of generators across languages that must not depend on each other.
  • You are doing cross-model generation and need mapping labels from one model to be available when generating another (requires checkpoints).
  • You want to fork the generation of certain models into a separate branch (e.g., generate both .java files and XML descriptors from the same input).
  • You want a conditional contribution added to a base plan without modifying it (PlanContribution).

Critical Directives

  • Genplan models use the genplan stereotype. File name pattern: <name>@genplan.mps. Pass moduleName: "<hosting module>" and modelName: "<name>@genplan" to mps_mcp_create_model. See aspect-model-stereotypes.md for all model identifiers. Set doNotGenerate=true (MPS adds this automatically).
  • Only one DevKit per model may carry a genplan. Assigning multiple genplan-bearing DevKits to the same model is unsupported.
  • Plan.steps is 1..n. A plan with no steps is invalid.
  • LanguageEntry.language (LanguageId) and GeneratorModulePointer.module (ModulePointer) are each cardinality 1 — missing them is a validation error.
  • Checkpoints persist transient state. Cross-phase reference resolution works only when phases share a plan AND a Checkpoint sits between them.
  • Do not hand-edit serialized .mps genplan files. Use MPS MCP node tools.

Common-Path Workflow

  1. Create a solution; add a model with stereotype genplan (file like MyPlan@genplan.mps).
  2. Add used languages jetbrains.mps.lang.generator.plan and jetbrains.mps.lang.smodel.
  3. Create a Plan root node with a descriptive name.
  4. Add Transform steps in order (one per phase); group parallel-safe languages in one Transform with multiple LanguageEntry children.
  5. Insert Checkpoint steps wherever downstream generators must resolve cross-model references.
  6. Add Fork steps for any output variant requiring its own branch (e.g. XML alongside Java); or add a separate PlanContribution root for conditional activation.
  7. Attach the plan to models via a DevKit (production) or the Custom generation facet (prototyping).
  8. Verify with MPS UI Show generation plan and mps_mcp_check_root_node_problems.
Show full SKILL.md (330 more words)Show less
  • mps-aspect-generator — for the generator rules and templates that the plan orchestrates.
  • mps-aspect-textgen — for the text serialization that consumes generated models.
  • mps-aspect-accessories — for DevKit setup, used languages, and runtime solutions that ship with a plan.
  • mps-node-editing — generic JSON-blueprint node creation workflow.

Reference Index

Start here — most common case: creating a plan and wiring it into a DevKit → read only references/plan-setup.md, plus references/step-catalog.md for the exact step concepts; cross-phase label resolution → only references/checkpoints.md; composing or branching plans → only references/composition-and-fork.md.

  • Plan setup and DevKit attachment — open when creating a new genplan model, wiring it into a DevKit, or switching between DevKit and Custom generation facet attachment. See references/plan-setup.md.
  • Step concept catalog — open when you need exact concept names, properties, cardinalities, and the meanings of Transform, ApplyGenerators, Checkpoint, IncludePlan, Fork, CheckpointDeclaration, CheckpointSynchronization, DocumentationStep. See references/step-catalog.md.
  • Transform and ApplyGenerators — open when wiring languages by identity (LanguageEntry.kind = Transform / TargetAt / Extend) or naming specific generator modules. Includes the verified "the plan" and "WithCompiledGenerator" JSON examples. See references/transform-and-applygenerators.md.
  • Checkpoints and cross-model resolution — open when phases need to share mapping labels, when a downstream plan must read another plan's checkpoint, or when picking among InPlaceCheckpointSpec, DeclaredCheckpointSpec, InPlaceCheckpointRefSpec. See references/checkpoints.md.
  • IncludePlan, Fork, and PlanContribution — open when composing plans from smaller pieces, splitting branches, or activating a conditional contribution without modifying the base plan. Includes "GenPlanWithFork", "LangConstraintsPlan", and "DocumentationPlan" JSON examples. See references/composition-and-fork.md.
  • Fork selectors and parameters — open when conditionally activating forks via ParameterEquals or ConceptListSelector, or defining a ParameterDeclaration. See references/fork-selectors.md.
  • Model attributes (InitModelAttributes, targetFacet) — open when routing the output of a branch to a specific facet such as documentation generation. Includes the verified ModelAttributeAssignment blueprint. See references/model-attributes.md.
  • Concept quick reference — open when assembling JSON that requires conceptReference strings or qualified concept names. See references/concept-quick-reference.md.
  • Verification and discovery — open to find existing plans (FIND_INSTANCES, search by name) or to validate a plan using MPS UI and MCP tools. See references/verification-and-discovery.md.
  • Authoring checklist — open at the end of an authoring session for a final scan before merging. See references/authoring-checklist.md.

© 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 11 other files (references) in .agents/skills/mps-aspect-generation-plan of JetBrains/MPS.

  • SKILL.md
  • references/aspect-model-stereotypes.md
  • references/authoring-checklist.md
  • references/checkpoints.md
  • references/composition-and-fork.md
  • references/concept-quick-reference.md
  • references/fork-selectors.md
  • references/model-attributes.md
  • references/plan-setup.md
  • references/step-catalog.md
  • references/transform-and-applygenerators.md
  • references/verification-and-discovery.md

Open the folder on GitHubat commit 3e9cfcd

Compare with similar skills

Mps Aspect Generation Plan 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 Aspect Generation Plan compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mps Aspect Generation Plan this skillJetBrains/MPS1.7k—~1.9kAutomated safety check: PassApache-2.0
Doc SyncJetBrains/ideavim10k2 repos~2.6kAutomated safety check: PassMIT
ChangelogJetBrains/ideavim10k1 repos~2.7kAutomated safety check: PassMIT
Youtrack CommunityJetBrains/intellij-community21k—~3.2kAutomated safety check: NotesCustom licence
Roo Conflict Resolutionzgsm-ai/costrict4.5k—~2.3kAutomated safety check: PassApache-2.0
Extensions API MigrationJetBrains/ideavim10k—~1.7kAutomated safety check: PassMIT

Similar skills

  • Doc Sync

    JetBrains/ideavim

    Official

    Keeps IdeaVim documentation in sync with code changes. An agent skill from JetBrains/ideavim.

    10k GitHub starsUsed in 2 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Changelog

    JetBrains/ideavim

    Official

    Maintains the IdeaVim changelog (CHANGES.md). An agent skill from JetBrains/ideavim.

    10k GitHub starsUsed in 1 repo~2.7k tokens
    DevelopmentAuto-check passed
  • Youtrack Community

    JetBrains/intellij-community

    Official

    YouTrack CLI for a community checkout; the monorepo uses youtrack.

    21k GitHub stars~3.2k tokensUpdated today
    DevelopmentAuto-check: notes
  • Roo Conflict Resolution

    zgsm-ai/costrict

    Provides comprehensive guidelines for resolving merge conflicts intelligently using git history and commit context.

    4.5k GitHub stars~2.3k tokensUpdated 10 days ago
    DevelopmentAuto-check passed
  • Extensions API Migration

    JetBrains/ideavim

    Official

    Migrates IdeaVim extensions from the old VimExtensionFacade API to the new @VimPlugin annotation-based API.

    10k GitHub stars~1.7k tokensUpdated today
    DevelopmentAuto-check passed
  • Architecture Canvas

    yulonghe97/draw-architecture

    Turn any system architecture into an interactive, pannable/zoomable canvas diagram (dark by default with a light switcher, JetBrains Mono, plane-coloured bands, click-to-isolate focus, PNG export) —…

    147 GitHub stars~1.3k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed

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 yesterday
    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 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, type queries, validation, MPS MCP tool usage, and the index of companion skills.

    1.7k GitHub stars~6.6k 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

Works with

Categories

Questions about Mps Aspect Generation Plan

What does Mps Aspect Generation Plan do?

A skill your agent uses when defining or modifying an MPS generation plan — explicit ordering of generators, checkpoints for cross-model reference resolution, forks for parallel branches…. Mps Aspect Generation Plan is an agent skill from JetBrains/MPS, published by the product's own GitHub organization. Use when defining or modifying an MPS generation plan — explicit ordering of generators, checkpoints for cross-model reference resolution, forks for parallel branches, IncludePlan composition, conditional PlanContribution activation, ParameterEquals/ConceptListSelector fork selectors, and InitModelAttributes for targetFacet routing.

When should I use Mps Aspect Generation Plan?

Mps Aspect Generation Plan fits situations like: modifying an MPS generation plan — explicit ordering of generators; checkpoints for cross-model reference resolution; forks for parallel branches; includePlan composition.

How do I install Mps Aspect Generation Plan in Claude Code?

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

How do I install Mps Aspect Generation Plan in Codex?

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

Can I use Mps Aspect Generation Plan 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-aspect-generation-plan -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-aspect-generation-plan, .gemini/skills/mps-aspect-generation-plan, .github/skills/mps-aspect-generation-plan and .opencode/skills/mps-aspect-generation-plan in your project.

What does Mps Aspect Generation Plan need to run?

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

Does Mps Aspect Generation Plan 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 Aspect Generation Plan 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 Aspect Generation Plan use?

Mps Aspect Generation Plan 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 Aspect Generation Plan use?

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

What are the alternatives to Mps Aspect Generation Plan?

Skills that share tags, products or a category with Mps Aspect Generation Plan: Doc Sync (JetBrains/ideavim, 10k stars), Changelog (JetBrains/ideavim, 10k stars), Youtrack Community (JetBrains/intellij-community, 21k stars) and Roo Conflict Resolution (zgsm-ai/costrict, 4.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mps Aspect Generation Plan?

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.