Name: mps-mcp-workflow
Rating: 71.2 (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

88%

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%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 well-structured, highly actionable reference body with clear sequenced workflows and validation checkpoints. Its main weakness is progressive disclosure: the body cites several references/*.md files that are not shipped in the bundle.

Suggestions

Ship the referenced bundle files (references/finding-things.md, node-editing-rules.md, reference-formats.md, bulk-creation.md, analysis-tools.md, editor-workflow.md, mcp-tools-index.md) or remove the 'Open references/...' lines, since the current body points to files that do not exist.

Tighten the longest Critical Directives (e.g. the Structure-to-Aspect chain) by moving the deep recovery detail into a reference and keeping only the ordered step list inline.

Verify every path mentioned in the 'Essential Skills (Detail)' section resolves under the skill directory so navigation is not broken.

Dimension	Reasoning	Score
Conciseness	Dense and expert-oriented, assuming Claude's competence without explaining basic concepts (PDF-style padding is absent); a few directives are lengthy but each carries substantive, non-obvious guidance, leaving only minor trim opportunities.	4 / 5
Actionability	Provides concrete tool names and arguments throughout (e.g. 'mps_mcp_alter_structure', 'mps_mcp_alter_nodes MAKE with rebuild=true', 'mps_mcp_get_concept_details' verifying descriptorStatus), giving copy-paste-ready, executable guidance for the common cases.	5 / 5
Workflow Clarity	The Structure-to-Aspect chain is a strictly numbered sequence with explicit validation checkpoints (verify descriptorStatus not 'hollow', mps_mcp_check_root_node_problems) and recovery/feedback loops, and the initialize-session workflow is similarly well-sequenced.	5 / 5
Progressive Disclosure	Good in-body structure with an 'Essential Skills (Detail)' section pointing to references/*.md files and a companion-skills table, but the referenced bundle files (references/finding-things.md, node-editing-rules.md, etc.) are not present in the skill bundle, so the one-level-deep navigation is not actually backed by real files.	3 / 5
	Total	17 / 20 Passed

Description

92%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 covers both what the skill does and when to use it with concrete trigger phrases. It is clearly distinguishable from other skills and avoids vague fluff.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete capabilities — 'models, languages, generators, node JSON blueprints, validation, MPS MCP tool usage, and the index of companion skills' — giving comprehensive coverage of the skill's scope.	5 / 5
Completeness	Explicitly answers both 'what' (complete MPS workflow guide for DSL projects covering the listed aspects) and 'when' (three explicit 'Use whenever...' trigger clauses).	5 / 5
Trigger Term Quality	Includes concrete, natural trigger phrasing ('Use whenever working in an MPS project', 'when AGENTS.md says to load the MPS workflow skill', 'when you need to pick the right MPS aspect-specific skill'), though the terms are domain-technical rather than the synonym/extension coverage seen in the top anchor.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche — JetBrains MPS workflow, MPS MCP tool usage, and companion-skill routing — with distinct triggers and minimal overlap risk against unrelated 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: 7 missing	Warning

	Total	14 / 16 Passed

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