CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

mps-mcp-workflow

Complete JetBrains MPS workflow guide for DSL projects — models, languages, generators, node JSON blueprints, type queries, 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

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

—

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exceptionally actionable reference with explicit workflows, validation checkpoints, and error-recovery loops for a complex toolchain domain. Its weaknesses are repetition and over-nested prose in the Critical Directives (hurting conciseness) and references to bundle files that are not present alongside the SKILL.md.

Suggestions

State the projectPath rule once in the Critical Directives and have the later notes ("Which project the tools act on", the install note) reference it instead of restating it, cutting a significant block of repeated text.

Move the multi-project repository rules and the install/refresh contract (each a long nested blockquote) into a reference file, keeping only a one-line pointer in SKILL.md.

Ship the referenced bundle files (references/*.md including references/analysis-tools/, scripts/mps_dump.py, scripts/examples/) with the skill, or remove references to files that are not part of the bundle, so the signaled navigation paths actually resolve.

DimensionReasoningScore

Conciseness

The body is dense with genuinely non-obvious domain knowledge (tool routing, ordering chains, exact error strings), but the projectPath rule is stated three times (the Critical Directive, the "Which project the tools act on" note, and the install note), and several directives are heavily nested walls of parenthetical sub-clauses (e.g. the scaffold-chain and multi-project notes). Mostly efficient but noticeably tighten-able — anchor 3, not 4.

3 / 5

Actionability

Guidance is fully executable: exact tool names with the stable mps_mcp_ prefix, exact parameter keys (nodeReference, conceptRefs, parameters.code), executable script invocations with real arguments, literal error strings ("Unable to determine the target project…", LANGUAGE_NOT_BUILT), and named recovery calls. Specific examples cover the common cases.

5 / 5

Workflow Clarity

Multi-step processes are explicitly sequenced with validation checkpoints and recovery loops: the numbered structure-edit → clean MAKE → verify descriptors → scaffold chain, the 5-step session-init workflow, "Validate frequently" with mps_mcp_check_root_node_problems after every mutation, rebuild-after-compiled-aspect-change rules, and failure recovery from rejection messages and EXPLAIN_TYPE. Matches the anchor-5 feedback-loop pattern.

5 / 5

Progressive Disclosure

The overview uses well-signaled, one-level-deep references ("Open references/finding-things.md for…", "See references/analysis-tools/type-queries.md") plus a companion-skills index table — good structure. However, none of the referenced files exist in the bundle (no references/, scripts/, or assets/ directories), so navigation is broken as presented, keeping this below anchor 5.

4 / 5

Total

17

/

20

Passed

Description

83%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 description with explicit what-and-when structure and concrete, domain-specific trigger phrases. Its main weaknesses are topic-noun enumeration instead of action verbs, a mild "Complete" over-claim, and minor overlap risk with the companion skills it indexes.

DimensionReasoningScore

Specificity

Enumerates concrete, specific artifacts — "node JSON blueprints", "type queries", "generators", "validation", "MPS MCP tool usage" — but presents them as topic nouns rather than actions, and "Complete" is a mild over-claim. It lists several specific items with minor gaps (anchor 4) rather than the action-verb comprehensiveness of anchor 5.

4 / 5

Completeness

Clearly answers "what" (workflow guide covering models, languages, generators, blueprints, type queries, validation, MCP tool usage, companion-skill index) and "when" with an explicit clause: "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" — three concrete trigger phrases matching the anchor-5 example.

5 / 5

Trigger Term Quality

Includes natural terms users would say in this niche — "MPS project", "JetBrains MPS", "DSL projects", "AGENTS.md" — giving good keyword coverage. Not 5: few synonyms or phrasing variations beyond the core "MPS" term; not 3: the coverage goes well beyond a single generic keyword.

4 / 5

Distinctiveness Conflict Risk

The JetBrains MPS niche is distinct with niche-specific triggers, but "Use whenever working in an MPS project" also matches the mps-* companion skills this skill indexes, creating minor overlap risk with closely related skills. Anchor 4 ("mostly distinct; minor overlap risk") is the closest fit; not 5 because the router-vs-companion boundary is not fully disambiguated.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 21 missing, 5 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

JetBrains/MPS

Path

.agents/skills/mps-mcp-workflow/SKILL.md

Reviewed

Table of Contents

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.