CtrlK
BlogDocsLog inGet started
Tessl Logo

mps-language-aspects-overview

Entry point for authoring or modifying an MPS language — index of all aspects (structure, editor, constraints, behavior, typesystem, intentions, actions, generator, textgen, accessories, generation plans), the recommended authoring order, cross-aspect call patterns, dependency/rebuild rules, and validation flow. Start here when defining a new language or when you do not know which aspect-specific skill applies.

69

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 router skill body that assumes competence, points cleanly to per-aspect skills, and gives concrete tooling and sequencing. Minor conciseness redundancy and the absence of a full executable example are the only drags on an otherwise strong reference.

Suggestions

De-duplicate the root-cause re-check guidance: state it once in 'Critical Directives' and reference it from 'Validation Flow' rather than restating it.

Add one short end-to-end worked example (e.g. adding a concept then re-validating downstream aspects) to lift actionability and workflow_clarity toward fully executable guidance.

Tighten the 'MCP Tools You'll Use Often' list by grouping or trimming so every listed tool maps to a step in the authoring/validation flow.

DimensionReasoningScore

Conciseness

The body is lean and table/bullet-driven, assuming MPS competence without padding; the only trim is minor redundancy where the root-cause re-check directive recurs in both 'Critical Directives' and 'Validation Flow'.

4 / 5

Actionability

It supplies concrete MCP tool names, exact model file paths, aspect IDs, and call syntax (e.g. 'node.m(...)', 'error ... fix { ... }'); as a router it has no full executable code block, but the guidance is specific and actionable.

4 / 5

Workflow Clarity

A numbered authoring order (1-9) and validation flow (1-4) with checkpoints plus a dependencies section give clear sequencing and a stated feedback loop, though the validation steps are brief without detailed error-recovery sub-steps.

4 / 5

Progressive Disclosure

As a router, the body is a clear overview with well-signaled one-level-deep references to dedicated aspect skills via a 'Detailed skill' table column, with content appropriately split and easy to navigate.

5 / 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 router description that concretely lists the aspects and guidance it indexes and gives explicit, natural trigger conditions for when to start here. Only trigger-term synonym coverage keeps it from a perfect mark across every dimension.

DimensionReasoningScore

Specificity

The description enumerates concrete contents comprehensively — 'index of all aspects (structure, editor, constraints, behavior, typesystem, intentions, actions, generator, textgen, accessories, generation plans), the recommended authoring order, cross-aspect call patterns, dependency/rebuild rules, and validation flow' — matching the comprehensive-coverage anchor.

5 / 5

Completeness

It explicitly answers both 'what' (entry point indexing all aspects, authoring order, call patterns, rules, validation flow) and 'when' ('Start here when defining a new language or when you do not know which aspect-specific skill applies') with concrete trigger phrases.

5 / 5

Trigger Term Quality

It includes natural domain phrases a user would say ('authoring or modifying an MPS language', 'defining a new language', 'aspect-specific skill') but lacks some common synonyms/variants, sitting between the good-coverage and comprehensive anchors.

4 / 5

Distinctiveness Conflict Risk

It carves a clear MPS-language-authoring niche with distinct router triggers ('when you do not know which aspect-specific skill applies'), minimizing conflict with other skills.

5 / 5

Total

19

/

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.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 20 suspicious

Warning

Total

14

/

16

Passed

Repository
JetBrains/MPS
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.