multiline-description

Normalizing multiline YAML frontmatter involves collapsing line breaks, indentation, and block scalars into a single-line discovery text while preserving meaning. This keeps metadata hygiene consistent for skill indexing and validation workflows.

Collapsing YAML block scalars in SKILL.md files requires preserving the original meaning while removing line breaks and indentation. Apply a normalization check to verify that the single-line output accurately reflects the wrapped description before using it for discovery.

Multiline markdown descriptions cause skill discovery issues because wrapped YAML block scalars break consistent name-and-description parsing. Metadata validation workflows require predictable, single-line discovery text to properly index and search skills without formatting anomalies.

Normalizing YAML frontmatter metadata works with markdown parsing workflows that process SKILL.md files. The normalization process targets the description block specifically, collapsing multiline content into a single line so existing metadata validation tools can parse it predictably.

You need to normalize multiline descriptions for skill metadata hygiene when a skill author writes a wrapped description in SKILL.md. Normalization is required before indexing, validation, or discovery workflows to ensure consistent, single-line, searchable text output.