CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

86%

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

77%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: dense tables, concrete MCP tool names and flags, a clear authoring order, and a validation flow with per-step error classes and rebuild rules. The main defect is bundle integrity — the body's only actual file reference (references/aspect-model-stereotypes.md) does not exist in the bundle, and the loader-protocol paragraph could be trimmed.

Suggestions

Fix the dangling reference: either ship references/aspect-model-stereotypes.md in the bundle or remove the link to it (currently no references/ directory exists, so the 'authoritative table' the body points to is unreachable).

Trim the 'Loading companion skills' paragraph to its two actionable rules (load siblings from the same catalog; never invent a tool name or endpoint) — the MCP-server vs filesystem-catalog branching adds tokens without changing what the reader does.

Add one concrete example invocation for the validation flow (e.g., a sample mps_mcp_check_root_node_problems call showing its target argument) so the first checkpoint is executable without first loading a companion skill.

DimensionReasoningScore

Conciseness

Mostly lean: it assumes MPS competence (no basics explained) and uses dense, high-value tables and lists ("Aspect IDs are case-sensitive and create models named `<langModule>.<aspectId>` with no `@` suffix"). Not 5 because the "Loading companion skills" paragraph spends many tokens on conditional loader protocol detail (MCP server vs filesystem catalog branches), and the one framing sentence "An MPS language is a collection of aspects, each a separate model inside the language module" slightly re-explains what the table already shows.

4 / 5

Actionability

Concrete and executable in the main: specific tool names with operation modes ("`mps_mcp_alter_structure` (CREATE_CONCEPTS, CREATE_ENUM, UPDATE_CONCEPT_*)", "`MAKE`, `rebuild:true`", "`runtimeReady:true`") and a specific 9-step authoring order. Not 5 because no example invocation with arguments is shown anywhere — the reader must load a companion skill even to run the first validation call — leaving minor gaps in copy-paste readiness.

4 / 5

Workflow Clarity

Clear sequences with explicit validation checkpoints: the numbered "Validation Flow" assigns each step the error class it catches ("catches concept-level problems", "catches compile errors in generated descriptors"), the "Dependencies and Rebuilds" section mandates re-validation per change type ("all callers ... must be re-validated"), and the closing directive gives an error-recovery loop ("re-check the root cause on the language side ... before patching generated Java"). Authoring order plus validation flow form a complete feedback-looped process.

5 / 5

Progressive Disclosure

Section structure and companion-skill routing are good — a dedicated table column ("Detailed skill") signals one-level-deep siblings, and the skill is appropriately an overview. But scored against the actual bundle: no references/, scripts/, or assets/ exist, so the prominent link "[aspect-model-stereotypes.md](references/aspect-model-stereotypes.md)" ("Authoritative table with usage notes and pitfalls") is a dead end, undermining navigation. Anchor 4 requires references to be mostly clear and functional; a dangling link to the skill's own advertised authoritative reference is a real organization gap, placing this between 3 and 4, at 3 because the missing file makes the stated routing unreliable.

3 / 5

Total

16

/

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 router-style description: it names the niche domain, enumerates all aspects and capability areas concretely, and includes an explicit "Start here when..." trigger clause for both new-language and uncertain-routing cases. Third-person voice is used throughout. The only minor gap is the absence of a few natural synonyms like "concept" or "DSL".

DimensionReasoningScore

Specificity

Lists multiple concrete capabilities — "index of all aspects (structure, editor, constraints, behavior, typesystem, intentions, actions, generator, textgen, accessories, generation plans)", plus "the recommended authoring order, cross-aspect call patterns, dependency/rebuild rules, and validation flow" — giving comprehensive, not just partial, coverage. Anchor 4 would require minor coverage gaps, but every major capability area of language authoring is explicitly enumerated.

5 / 5

Completeness

Explicitly answers both: what — "Entry point for authoring or modifying an MPS language — index of all aspects ... dependency/rebuild rules, and validation flow"; and when — "Start here when defining a new language or when you do not know which aspect-specific skill applies." Both are concrete with explicit trigger phrases, matching the anchor-5 example structure.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "authoring or modifying an MPS language" plus all the aspect names ("structure, editor, constraints, behavior, typesystem", "generator, textgen") that MPS users would naturally say. Not 5 because common synonyms like "concept", "DSL", or file extensions (.mps, .mpl) are absent; not 3 because the aspect-name coverage is broad and natural rather than partial.

4 / 5

Distinctiveness Conflict Risk

"MPS language" is a clear niche with distinct triggers, and the routing clause "when you do not know which aspect-specific skill applies" explicitly positions it as the router among sibling aspect skills, minimizing wrong-skill triggering. No overlap risk with generic skills since MPS authoring is unambiguous.

5 / 5

Total

19

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 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: 1 missing

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

13

/

16

Passed

Repository

JetBrains/MPS

Path

.agents/skills/mps-language-aspects-overview/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.