multiline-description

To normalize multiline YAML frontmatter descriptions, the parser collapses newline characters while preserving content semantics, converting multiline text blocks into a single-line form for consistent display and indexing.

Multiline YAML metadata causes indexing inconsistencies because newline characters and text block formatting fragment the description field, making metadata harder to search and display uniformly across skill catalogs.

The best way to convert multiline YAML frontmatter for a skill catalog is to apply normalization during loading, collapsing multiline description fields to a single-line form while preserving semantic meaning.

Normalizing YAML frontmatter preserves the original content semantics by collapsing newline characters structurally without altering the text meaning, ensuring the single-line output retains the full description value.

You can use this to prepare multiline metadata before importing skills into a catalog by applying normalization to ensure uniform metadata representation across all imported skill records.

Limitations of collapsing multiline YAML descriptions include potential readability loss in the raw frontmatter file, as newline formatting is removed to achieve a compact, single-line representation for indexing.