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

mps-mcp-workflow

Complete JetBrains MPS workflow guide for DSL projects — models, languages, generators, node JSON blueprints, validation, MPS MCP tool usage, and the index of companion skills. Use whenever working in an MPS project, when AGENTS.md says to load the MPS workflow skill, or when you need to pick the right MPS aspect-specific skill.

Quality

92%

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

85%

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

A well-structured, highly actionable reference entry point with clear sequenced workflows and clean one-level-deep reference navigation. Its main weakness is mild verbosity in the inline multi-project rules and concept-primer sections that could be tightened or moved to a reference.

Suggestions

Move the lengthy 'Multi-project repository rules' blockquote (lines 35–39) into a dedicated reference file, leaving a one-line pointer in SKILL.md to reduce entry-point token load.

Condense the Key Concepts primer to only MPS-specific notions a capable model would not already know, or relocate the full glossary to a reference.

The unreferenced bundle file aspect-model-stereotypes.md is not surfaced from the body — either link it from a relevant section or drop it from the bundle to keep navigation complete.

Dimension	Reasoning	Score
Conciseness	Mostly efficient and dense with operational detail, but the long multi-project rules blockquote and the Key Concepts primer (modules/models/nodes/aspects) explain material that could be tightened or offloaded to a reference, slightly padding the entry point.	2 / 3
Actionability	Highly actionable instruction-only guidance: exact tool names (mps_mcp_alter_structure, mps_mcp_get_concept_details, mps_mcp_scaffold_editor), explicit ordered sequences, and concrete field/flag values (descriptorStatus "hollow", recoveryStage "module-rebuild").	3 / 3
Workflow Clarity	The Structure-to-Aspect Prerequisite Chain is a numbered 1–4 sequence with an explicit verify-descriptors checkpoint and a recovery/shortcut path, and the Initialize-a-Session workflow includes validation steps, giving clear feedback loops for risky operations.	3 / 3
Progressive Disclosure	The Essential Skills section clearly signals seven one-level-deep references with one-line summaries, and every referenced file (finding-things.md, node-editing-rules.md, reference-formats.md, bulk-creation.md, analysis-tools.md, editor-workflow.md, mcp-tools-index.md) exists in references/, giving easy navigation.	3 / 3
	Total	11 / 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 strong, third-person description that clearly states what the skill covers and gives explicit, natural trigger conditions. It is specific, complete, and well-differentiated from sibling MPS skills.

Dimension	Reasoning	Score
Specificity	Enumerates concrete scope items — "models, languages, generators, node JSON blueprints, validation, MPS MCP tool usage, and the index of companion skills" — listing multiple specific capabilities rather than vague language.	3 / 3
Completeness	Explicitly answers both what (the enumerated MPS workflow scope) and when ("Use whenever working in an MPS project, when AGENTS.md says to load the MPS workflow skill, or when you need to pick the right MPS aspect-specific skill").	3 / 3
Trigger Term Quality	Natural domain triggers a user would say appear — "working in an MPS project", "DSL projects", "pick the right MPS aspect-specific skill" — with good coverage for this niche.	3 / 3
Distinctiveness Conflict Risk	Sharply niched to JetBrains MPS with distinct triggers (MPS project, AGENTS.md load directive, aspect-skill selection), making it unlikely to fire for an unrelated skill.	3 / 3
	Total	12 / 12 Passed

Validation

93%

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

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

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

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