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

100%

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

100%

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

A well-architected skill body: dense MPS-specific guidance with no filler, concrete tool calls throughout, an 8-step workflow with explicit validation and output-reading feedback loops, and a clean reference index where every cited bundle file exists and is labeled with its purpose. The only minor nit is two cross-skill pointers to sibling skills (runtime-solutions.md, aspect-model-stereotypes.md) that live outside this bundle, but these are intentional cross-skill links, not broken in-skill nesting.

Dimension	Reasoning	Score
Conciseness	Every section carries MPS-specific operational knowledge Claude does not already have (stable-vs-variable split, ref-form gotchas, silent-failure modes) with no generic-concept padding, fitting 'lean and efficient; assumes Claude's competence'.	3 / 3
Actionability	Provides concrete executable tool calls with arguments — `mps_mcp_get_project_structure(moduleKind="Language")`, `mps_mcp_create_module(type="generator", parentLanguage="<lang>")`, `mps_mcp_check_root_node_problems`, `mps_mcp_alter_nodes MAKE` — plus exact ref forms and output path conventions, matching 'fully executable code/commands; copy-paste ready'.	3 / 3
Workflow Clarity	The 8-step common-path workflow has an explicit validation checkpoint (step 7: check_root_node_problems, re-run with onlyNodesWithProblems=false) and a read-the-output feedback loop (step 8), with Critical Directives for error recovery — matching 'clear sequence with explicit validation steps; feedback loops'.	3 / 3
Progressive Disclosure	SKILL.md is an overview; the Reference Index lists 19 one-level-deep bundle files, each with a 'read when …' purpose line, all verified to exist in references/. Content is appropriately split with easy navigation, matching the 'clear overview with well-signaled one-level-deep references' anchor.	3 / 3
	Total	12 / 12 Passed

Description

100%

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 dense, specific description that names concrete generator-authoring actions, lists the full macro vocabulary, and pairs them with explicit 'Use when' triggers including debugging scenarios. It cleanly answers both what the skill does and when to invoke it, and is unmistakably distinct from sibling MPS aspect skills.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'author a generator module', 'add or edit root/reduction/weaving/pattern mapping rules', 'attach template macros' (12 named), 'wire mapping labels', 'build template switches', 'write pre/post mapping scripts', 'navigate genContext' — matching the 'lists multiple specific concrete actions' anchor.	3 / 3
Completeness	An explicit 'Use when …' clause answers 'when', and the enumerated action list answers 'what', satisfying the 'clearly answers both what AND when with explicit triggers' anchor.	3 / 3
Trigger Term Quality	Natural niche triggers an MPS developer would actually say — 'defining or modifying MPS generators', debug 'rule didn't fire', 'missing references', 'empty output', 'infinite reduction loops', 'generated-Java compile failures' — giving good coverage of the domain's natural vocabulary.	3 / 3
Distinctiveness Conflict Risk	The MPS-generator niche with named macros ($COPY_SRC, $LOOP, …) and specific failure symptoms is clearly distinct from sibling MPS skills and unlikely to trigger for the wrong skill.	3 / 3
	Total	12 / 12 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
relative_links	Relative link issues: 1 suspicious	Warning

	Total	14 / 16 Passed

Repository: JetBrains/MPS
Path: .agents/skills/mps-aspect-generator/SKILL.md
Commit: 52c9d63

Reviewed: about 5 hours 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.