Name: mps-baselanguage
Rating: 74.4 (1 reviews)
Author: JetBrains

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

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

96%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.

The body is an exemplary dense, actionable overview with a strong sequenced workflow and validation gates. Its only weakness is progressive disclosure: the Reference Index names seven reference files that do not exist in the bundle.

Suggestions

Ship the referenced bundle files (references/concept-mapping.md, json-patterns.md, critical-rules.md, parse-java-tips.md, stub-references.md, json-ast-workflow.md, troubleshooting.md) so the Reference Index links resolve.

If any referenced file is not intended to be provided, remove its entry from the Reference Index or mark it as planned to avoid dangling pointers.

Dimension	Reasoning	Score
Conciseness	Lean and dense throughout — it assumes Claude's MPS/SNode knowledge, never explains what MPS or an AST is, and every directive (node equality, ClassCreator wiring, surgical edits) earns its place.	5 / 5
Actionability	Concrete tool names (mps_mcp_parse_java_and_insert, mps_mcp_update_node, mps_mcp_alter_nodes MAKE), exact role names (baseMethodDeclaration, returnType), and specific signatures make the guidance directly executable rather than abstract.	5 / 5
Workflow Clarity	The 8-step Common Workflow is explicitly sequenced with a three-gate validation checkpoint (dryRun:true, check_root_node_problems, alter_nodes MAKE) and a FIX_REFERENCES repair feedback loop, fitting the destructive AST-mutation context.	5 / 5
Progressive Disclosure	A well-signaled Reference Index points one level deep to seven references/*.md files each with an 'Open ... when ...' trigger, but those referenced files are not present in the bundle, so the navigation cannot actually be followed.	4 / 5
	Total	19 / 20 Passed

Description

90%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.

A strong, specific description that clearly states both the capability set and the trigger conditions in third person. Slight room to broaden trigger synonyms, but it is otherwise comprehensive and distinctive.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Author and edit', 'choose between the Java parser and JSON AST blueprints', 'map Java syntax to baseLanguage concepts/roles', 'harvest persistent member references', and 'validate' — giving comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	Explicitly answers both 'what' (author/edit, choose paths, map syntax, harvest refs, validate) and 'when' via the concrete 'Use when writing class/method bodies... especially when BaseLanguage extensions... are involved' clause.	5 / 5
Trigger Term Quality	Natural triggers like 'writing class/method bodies, fields, expressions, statements' and 'Java/BaseLanguage code inside MPS models' are present and would be said by users, but it leans on domain jargon ('persistent member references') and misses a few common synonyms.	4 / 5
Distinctiveness Conflict Risk	The highly specific MPS niche ('jetbrains.mps.baseLanguage', 'BaseLanguage extensions (smodel, closures, collections)') with distinct triggers gives it a clear niche and minimal conflict risk with other skills.	5 / 5
	Total	19 / 20 Passed

Validation

87%

Warnings & errors only

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

Criteria	Description	Result
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
Commit: c74b207

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.