mps-aspect-generator

Use when defining or modifying MPS generators — author a generator module, add or edit root/reduction/weaving/pattern mapping rules, attach template macros ($COPY_SRC, $LOOP, $IF, $PROPERTY, $REF, $SWITCH, $MAP_SRC, $WEAVE, $INSERT, $LABEL, $TRACE, $VAR), wire mapping labels, build template switches, write pre/post mapping scripts, navigate `genContext`, or debug "rule didn't fire", missing references, empty output, infinite reduction loops, and generated-Java compile failures.

Quality

94%

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

88%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-level reference skill: concrete MCP tool calls, a validated multi-step workflow with feedback loops, and clean progressive disclosure via a Reference Index. The only real weakness is that the many referenced files cannot be verified in the bundle and a few prose asides could be tighter.

Suggestions

Tighten workflow step 1: move the extended startingPoint resolution caveat into a reference file, keeping the step to the core locate-or-create action.

Ensure every references/*.md path listed in the Reference Index ships with the skill bundle so the one-level-deep navigation has no dead ends.

Consider trimming the opening 'A generator transforms models...' definition paragraph, since the intended reader already knows what an MPS generator is.

Dimension	Reasoning	Score
Conciseness	Dense and expert-level throughout — it assumes Claude knows MPS and avoids basics — but workflow step 1's long parenthetical on startingPoint resolution and the opening definition paragraph are minor instances that could be trimmed. Not a 5 because a few asides do not each earn their place.	4 / 5
Actionability	Provides concrete, executable guidance: named MCP tools with parameters ('mps_mcp_get_project_structure(moduleKind="Language")', 'mps_mcp_create_root_node', 'mps_mcp_check_root_node_problems', 'mps_mcp_alter_nodes MAKE'), exact ref forms ('r:<modelUUID>(<lang>.structure)/<nodeId>'), and a concrete output path convention — copy-paste ready commands covering common cases.	5 / 5
Workflow Clarity	An 8-step Common-path workflow with explicit validation (step 7 check_root_node_problems, re-run with onlyNodesWithProblems=false) and feedback loops (MAKE before reading to avoid staleness, Tracer/$TRACE$ to bisect misgenerated fragments), plus a destructive-op guard against hand-editing .mps files.	5 / 5
Progressive Disclosure	Well-structured overview with a thorough Reference Index giving one-line descriptions of one-level-deep reference files, and details pushed out of SKILL.md. Capped at 4 rather than 5 because the referenced references/*.md files are not present in the bundle to verify, and several cross-skill reference paths (mps-aspect-accessories/..., ../mps-mcp-workflow/...) add navigation complexity.	4 / 5
	Total	18 / 20 Passed

Description

100%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 exemplar description: it opens with an explicit 'Use when' trigger, enumerates concrete authoring and debugging actions, and names the specific failure modes a user would voice. Niche-specific terms keep conflict risk minimal.

Dimension	Reasoning	Score
Specificity	Lists many concrete actions — 'author a generator module, add or edit root/reduction/weaving/pattern mapping rules, attach template macros ($COPY_SRC, $LOOP, ...), wire mapping labels, build template switches, write pre/post mapping scripts, navigate genContext' — with comprehensive coverage of the generator aspect.	5 / 5
Completeness	Explicitly answers both what ('author a generator module, add or edit ... mapping rules, attach template macros ...') and when ('Use when defining or modifying MPS generators ... or debug ...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Highly natural trigger phrases a user would actually say, including the debug symptoms 'rule didn't fire', 'missing references', 'empty output', 'infinite reduction loops', 'generated-Java compile failures' alongside concrete macro names.	5 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (MPS generator aspect) with distinctive triggers like $COPY_SRC, genContext, reduction loops, and mapping labels that would not fire for unrelated skills.	5 / 5
	Total	20 / 20 Passed

Validation

81%

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 — 13 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning
relative_links	Relative link issues: 1 suspicious	Warning
referenced_paths_exist	Referenced path issues: 25 missing	Warning

	Total	13 / 16 Passed

Repository: JetBrains/MPS
Path: .agents/skills/mps-aspect-generator/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.