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`.

71

Quality

89%

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 strong, expert-level reference skill: lean body, concrete MCP tool calls, a sequenced workflow with an explicit validation step, and an exemplary one-level-deep Reference Index. The main gaps are a duplicated prerequisite block, JSON payloads deferred to a reference, and an error-recovery loop delegated to common-failures.md.

Suggestions

Consolidate the model-creation prerequisite: the aspect-ID/used-languages detail is repeated in both the intro paragraph and step 1 — keep the full detail in step 1 and reduce the intro to a one-line pointer.

Inline one minimal ConceptTextGenDeclaration JSON skeleton (or a tiny append example) so the core insert is copy-paste ready without opening references/json-blueprints.md.

Add an explicit validate→fix→retry feedback loop in step 6 (what to do when mps_mcp_check_root_node_problems reports problems) rather than delegating recovery entirely to references/common-failures.md.

DimensionReasoningScore

Conciseness

Dense and expert-level with no padding about what MPS or TextGen is, but the model-creation prerequisite (aspect ID `textGen`, case-sensitive, no `@` suffix, the three used languages) is repeated nearly verbatim in the intro paragraph and again expanded in step 1 — a minor trim candidate. Not 5 because of that duplication; not 3 because every line earns its place.

4 / 5

Actionability

Concrete, specific tool calls with parameters ("mps_mcp_create_model with modelName: '<lang>.textGen'", "mps_mcp_insert_root_node_from_json", "mps_mcp_check_root_node_problems") and exact used-language FQNs, but the actual executable AST/JSON shapes are deferred to references/json-blueprints.md rather than shown inline — a minor gap. Not 5 because the copy-paste-ready insert payload lives in a reference; not 3 because the named tool calls are themselves concrete commands.

4 / 5

Workflow Clarity

A clear six-step sequenced Common-Path Workflow with an explicit validation step (step 6: validate via check_root_node_problems, rebuild, regenerate, inspect) and a stated failure mode in step 1, but the validate→fix→retry feedback loop is delegated to common-failures.md rather than stated inline. Not 5 because the error-recovery loop is referenced out; not 3 because validation is explicitly present (so the destructive/batch cap does not apply).

4 / 5

Progressive Disclosure

The body is a genuine overview that points to a well-signaled, one-level-deep Reference Index ("Open references/X.md when Y") covering seven reference files organized for discovery, with Related Skills listed separately — matching the highest anchor for clear overview plus easy navigation. No bundle files are present in this review copy, so the score reflects the disclosure structure as written.

5 / 5

Total

17

/

20

Passed

Description

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

An exemplary description: it pairs a precise statement of what the skill does with two natural explicit trigger clauses, lists concrete constructs for comprehensive coverage, and carves out a distinct niche with low conflict risk. It does not over-claim or pad.

DimensionReasoningScore

Specificity

Lists multiple concrete constructs and actions — "ConceptTextGenDeclaration roots", "append / indent buffer / with indent statements", "text layout areas", "context objects", "binary write", "found error", "the indentation-buffer model" — giving comprehensive coverage of the skill's surface area.

5 / 5

Completeness

Explicitly answers both what ("concept-to-plain-text serialisation for languages whose final output is text") and when with two concrete trigger clauses ("Use when authoring or debugging..." and "Reach for this skill whenever..."), satisfying the highest anchor.

5 / 5

Trigger Term Quality

Natural trigger phrases an MPS user would actually say ("authoring or debugging MPS TextGen", "Reach for this skill whenever the task involves editing `<lang>/languageModels/textGen.mps`") plus file-type synonyms and extensions ("source files, config, scripts, DDL, XML, markdown").

5 / 5

Distinctiveness Conflict Risk

A tightly scoped MPS TextGen-aspect niche with distinct triggers and minimal overlap risk; the "final output is text" framing cleanly separates it from the model-to-model generator aspect.

5 / 5

Total

20

/

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.

Validation13 / 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

referenced_paths_exist

Referenced path issues: 14 missing

Warning

Total

13

/

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.