CtrlK
BlogDocsLog inGet started
Tessl Logo

mps-aspect-generation-plan

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.

66

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

—

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-organized, information-dense reference body with a clearly sequenced workflow and named MCP tools, held back by a broken disclosure layer: every referenced companion file is missing from the bundle, so the promised JSON examples and checklists are unreachable. Concise and actionable, but a few sections duplicate each other and validation lacks an error-recovery loop.

Suggestions

Ship the referenced bundle files: create the references/ directory with the ten files the index cites (plan-setup.md, step-catalog.md, checkpoints.md, composition-and-fork.md, fork-selectors.md, model-attributes.md, concept-quick-reference.md, verification-and-discovery.md, authoring-checklist.md, aspect-model-stereotypes.md) so the links resolve.

Inline at least one minimal verified JSON blueprint (e.g. a bare Plan with one Transform step) in SKILL.md so the common case is copy-paste executable without relying on the reference files.

Add an explicit feedback loop to step 8 of the workflow: if `mps_mcp_check_root_node_problems` reports problems (e.g. missing cardinality-1 `LanguageId`/`ModulePointer`), fix and re-run the check before proceeding.

DimensionReasoningScore

Conciseness

The body is dense and domain-specific throughout — e.g. "`Plan.steps` is `1..n`", "Only one DevKit per model may carry a genplan", cardinality rules — with no padding explaining concepts Claude already knows. It falls just short of the 5 anchor because the "When to use a generation plan" section and the "Start here" line in the Reference Index partially duplicate information already given (the frontmatter description and the index bullets), and could be trimmed.

4 / 5

Actionability

Guidance is concrete and executable: "Pass `moduleName: \"<hosting module>\"` and `modelName: \"<name>@genplan\"` to `mps_mcp_create_model`", exact file pattern "`<name>@genplan.mps`", and named tools like `mps_mcp_check_root_node_problems`. Not a 5 because the concrete JSON blueprints the index promises ("Includes the verified 'the plan' and 'WithCompiledGenerator' JSON examples") are deferred to reference files rather than shown, leaving a gap in copy-paste readiness.

4 / 5

Workflow Clarity

The 8-step "Common-Path Workflow" is clearly sequenced and ends with an explicit validation step ("Verify with MPS UI **Show generation plan** and `mps_mcp_check_root_node_problems`"). It matches the 4 anchor rather than 5 because there is no error-recovery feedback loop (what to do when the root-node check reports problems) and the "authoring checklist" for a final scan is deferred to a reference rather than stated inline.

4 / 5

Progressive Disclosure

Structurally this is near-ideal: a lean overview, a well-signaled one-level-deep Reference Index with per-entry "open when…" triggers and a "Start here — most common case" routing line. However, none of the ten referenced files (references/plan-setup.md, step-catalog.md, checkpoints.md, composition-and-fork.md, fork-selectors.md, model-attributes.md, concept-quick-reference.md, verification-and-discovery.md, authoring-checklist.md, aspect-model-stereotypes.md) exist in the bundle — no references/ directory is present — so every navigation link is dead and the disclosure structure cannot actually deliver, matching the 3 anchor (structure present, references present but non-resolving) rather than 4–5.

3 / 5

Total

15

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description for a niche domain: it concretely states what the skill does and gives two explicit, complementary "use when / apply when" trigger clauses covering creation, wiring, and debugging scenarios. The only minor gap is a few natural keyword variants (file-extension patterns, "generator plan" phrasing), which keeps trigger term quality at 4 rather than 5.

DimensionReasoningScore

Specificity

It lists multiple concrete capabilities: "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" — comprehensive, specific coverage matching the 5 anchor, and clearly not the 4 anchor since no notable capability area is missing.

5 / 5

Completeness

Both halves are explicit: the "what" ("defining or modifying an MPS generation plan — explicit ordering of generators, checkpoints…, forks…, IncludePlan composition…") and the "when" ("Use when defining or modifying…" plus a second explicit trigger clause "Apply when working with @genplan models… or debugging cross-model mapping label resolution"). This matches the 5 anchor's pattern of concrete what-and-when trigger phrasing.

5 / 5

Trigger Term Quality

Good natural-term coverage for the domain: "MPS generation plan", "@genplan models", "jetbrains.mps.lang.generator.plan", "DevKits", "Custom generation facet", "cross-model mapping label resolution" — the phrases an MPS user would actually say. Not 5 because a few natural variations are absent (e.g. the `.mps` file extension / "genplan.mps" pattern, "generator plan" phrasing), and not 3 because it clearly goes beyond "some relevant keywords" to near-comprehensive domain vocabulary.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche with distinct triggers — the genplan stereotype, the specific language id, DevKit vs. Custom generation facet attachment, checkpoint/fork selector vocabulary — that no adjacent skill (generator rules, textgen, accessories) would claim, matching the 5 anchor's "clear niche with distinct triggers; minimal conflict risk".

5 / 5

Total

19

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 11 missing

Warning

referenced_paths_exist

Referenced path issues: 25 missing

Warning

Total

13

/

16

Passed

Repository
JetBrains/MPS
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.