CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

mps-baselanguage

Author and edit MPS `jetbrains.mps.baseLanguage` (Java) nodes — choose between the Java parser and JSON AST blueprints, map Java syntax to baseLanguage concepts/roles, harvest persistent member references, and validate. Use when writing class/method bodies, fields, expressions, statements, or any Java/BaseLanguage code inside MPS models, especially when BaseLanguage extensions (smodel, closures, collections) are involved.

Quality

91%

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

85%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 strong, expert-calibrated reference skill: terse non-obvious rules, a fully validated workflow with repair loops, and exemplary reference navigation. The only improvements are minor: trim the generic loader-policy boilerplate, and the absence of any inline example means the body alone is not fully copy-paste ready.

Suggestions

Trim or shorten the generic 'Loading companion skills' paragraph — it is host boilerplate unrelated to baseLanguage specifics and consumes ~90 tokens of context.

Inline one minimal ready-to-paste JSON blueprint (e.g. a LocalVariableDeclarationStatement or InstanceMethodCallOperation) in the body so the most common constructs are executable without opening references/json-patterns.md.

Split the long Compatibility bullet into separate bullets for blueprint Java-7 limits vs. parser lambda handling, and verify all seven referenced files (references/concept-mapping.md, json-patterns.md, critical-rules.md, parse-java-tips.md, stub-references.md, json-ast-workflow.md, troubleshooting.md) actually ship with the skill bundle — none were present to verify here.

DimensionReasoningScore

Conciseness

The body is dense and expert-only — every directive states a non-obvious MPS rule (":eq: instead of ==", "ConstructorDeclaration.returnType MUST be a VoidType node") with no padding or explanation of concepts Claude already knows. Two minor trimmable spots keep it below anchor 5: the ~90-word generic "Loading companion skills" loader-policy paragraph, and the long Compatibility bullet that packs three distinct topics (blueprint Java-7 limits, parser lambda handling, records) into one passage.

4 / 5

Actionability

Guidance is highly concrete — exact tool names and flags ("mps_mcp_update_node", "dryRun: true", "mps_mcp_alter_nodes FIX_REFERENCES"), exact concepts/roles ("NPEEqualsExpression", "ClassCreator.baseMethodDeclaration", "LocalVariableDeclarationStatement"), and a precise placeholder-swap strategy. It falls short of anchor 5 only because copy-paste-ready examples (JSON blueprints, Java snippets) are deferred to the reference files rather than shown inline for the most common constructs.

4 / 5

Workflow Clarity

The Common Workflow gives a clearly sequenced 8-step process with an explicit three-gate validation ("dryRun: true… mps_mcp_check_root_node_problems — semantic checking… mps_mcp_alter_nodes MAKE — generation + compilation") and a feedback loop for error recovery ("run mps_mcp_alter_nodes FIX_REFERENCES rather than re-harvesting"). This matches the anchor for clear sequence with explicit validation steps and error-recovery loops, including the tool-choice decision guidance in Choose Your Path.

5 / 5

Progressive Disclosure

The body is a true overview: critical rules inline, and a Reference Index where each of the seven reference files is one level deep and explicitly signaled with a when-to-open trigger ("Open references/json-patterns.md when you need ready-to-paste JSON blueprints…"). Note: no references/ directory was present in the review bundle, so the referenced files' existence could not be verified; the structural organization itself fully matches the anchor for a clear overview with well-signaled one-level-deep references.

5 / 5

Total

18

/

20

Passed

Description

96%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: concrete multi-action capability statement, explicit and well-phrased trigger guidance, and third-person voice with no fluff. Its only weakness is that the extension-related triggers (smodel, closures, collections) sit close to the territory of sibling skills in the same family.

DimensionReasoningScore

Specificity

The description lists five concrete, distinct capabilities — "choose between the Java parser and JSON AST blueprints", "map Java syntax to baseLanguage concepts/roles", "harvest persistent member references", and "validate" — comprehensively covering the skill's actions with no vague filler. This matches the anchor for multiple specific concrete actions with comprehensive coverage; score 4 would require minor gaps in coverage, which are not evident.

5 / 5

Completeness

It explicitly answers both questions: the "what" ("Author and edit MPS jetbrains.mps.baseLanguage (Java) nodes… harvest persistent member references, and validate") and the "when" ("Use when writing class/method bodies, fields, expressions, statements, or any Java/BaseLanguage code inside MPS models, especially when BaseLanguage extensions… are involved") with concrete trigger phrases. This is a direct match to the anchor-5 example pattern; anchor 4 would require a less explicit 'when' clause.

5 / 5

Trigger Term Quality

It includes the natural phrases an MPS user would say — "writing class/method bodies, fields, expressions, statements", "Java/BaseLanguage code inside MPS models" — plus the domain synonyms users actually name ("smodel, closures, collections", "Java parser"). Coverage is comprehensive for this domain; file extensions are not applicable to MPS models, so the anchor-5 standard is met by the synonym and phrasing breadth.

5 / 5

Distinctiveness Conflict Risk

The niche is clear (authoring baseLanguage ASTs in MPS models), but the trigger "especially when BaseLanguage extensions (smodel, closures, collections) are involved" overlaps with closely related sibling skills that own those extensions (mps-collections-and-closures, mps-model-manipulation). That is minor overlap risk with closely related skills — anchor 4 — rather than the minimal-conflict profile of anchor 5.

4 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 8 missing

Warning

Total

14

/

16

Passed

Repository

JetBrains/MPS

Path

.agents/skills/mps-baselanguage/SKILL.md

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.