CtrlK
BlogDocsLog inGet started
Tessl Logo

mps-aspect-textgen

Use when authoring or debugging MPS TextGen — concept-to-plain-text serialisation for languages whose final output is text (source files, config, scripts, DDL, XML, markdown). Covers `ConceptTextGenDeclaration` roots, `append` / `indent buffer` / `with indent` statements, text layout areas, context objects (e.g. imports sets), attributes, the base text gen component (`LanguageTextGenDeclaration`), binary `write`, `found error`, and the indentation-buffer model. Reach for this skill whenever the task involves editing `<lang>/languageModels/textGen.mps`.

73

Quality

92%

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

100%

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

A high-quality reference skill: dense and assumption-respecting, fully actionable with real tool calls, a sequenced workflow with validation, and clean one-level-deep progressive disclosure backed by verified reference files. No dimension scored below the top anchor.

DimensionReasoningScore

Conciseness

Lean and information-dense: assumes MPS/BaseLanguage competence, never explains what a concept or generation is, and every directive earns its place; matches the 'lean and efficient, every token earns its place' anchor rather than the padded 2-anchor.

3 / 3

Actionability

Gives concrete executable guidance — exact MCP tool names (mps_mcp_create_model, mps_mcp_insert_root_node_from_json, mps_mcp_check_root_node_problems), exact model/aspect IDs and required used-languages, and a pointer to validated AST shapes in references/json-blueprints.md — matching the copy-paste-ready anchor.

3 / 3

Workflow Clarity

Numbered Common-Path Workflow with explicit sequencing, an upfront prerequisite gate, and a validation checkpoint (step 6: check_root_node_problems, rebuild, regenerate consumers), matching the clear-sequence-with-explicit-validation anchor.

3 / 3

Progressive Disclosure

SKILL.md is a concise overview with a Reference Index that signals each one-level-deep reference by trigger condition; all eight referenced files (statements-and-appends, indentation-model, json-blueprints, etc.) exist in ./references, and detail is appropriately split out rather than inlined.

3 / 3

Total

12

/

12

Passed

Description

85%

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, well-triggered description for a narrow technical niche, clearly stating both what it does and when to use it. The main weakness is trigger-term quality: natural-language phrasings are overshadowed by dense MPS jargon, narrowing the audience that would recognize the trigger.

Suggestions

Add one or two plain-language trigger phrasings a non-expert might say (e.g. 'when generating source files / SQL / XML from an MPS model') alongside the technical terms.

Keep 'Reach for this skill whenever the task involves editing <lang>/languageModels/textGen.mps' but consider also naming the common user goal (e.g. 'turning an MPS model into text files').

DimensionReasoningScore

Specificity

Lists multiple concrete capabilities and artifacts ('concept-to-plain-text serialisation', 'ConceptTextGenDeclaration roots', 'append / indent buffer / with indent', 'binary write', 'found error'), matching the 'lists multiple specific concrete actions' anchor.

3 / 3

Completeness

Explicitly answers both what ('concept-to-plain-text serialisation... Covers ...') and when ('Use when authoring or debugging', 'Reach for this skill whenever the task involves editing ...'), matching the 'clearly answers both what AND when' anchor.

3 / 3

Trigger Term Quality

Has relevant triggers ('Use when authoring or debugging', 'editing <lang>/languageModels/textGen.mps') but is dominated by technical jargon (ConceptTextGenDeclaration, LanguageTextGenDeclaration) and lacks broader natural phrasings a less-expert user would say; not a 1 because natural triggers are present, not a 3 because coverage of common variations is thin.

2 / 3

Distinctiveness Conflict Risk

A clear narrow niche (MPS TextGen aspect, the specific textGen.mps file) with distinct triggers unlikely to collide with sibling skills like mps-aspect-generator.

3 / 3

Total

11

/

12

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: 1 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.