multiline-description

To normalize multiline YAML descriptions in SKILL.md files, you verify that multiline text is correctly converted to single lines in the YAML frontmatter while preserving the Markdown body for operational instructions.

YAML frontmatter descriptions break across multiple lines because the parser requires normalization to convert multiline strings into a single valid line for proper formatting and display.

You validate YAML frontmatter formatting by checking that the name and description fields are properly normalized, ensuring multiline descriptions convert to single lines without losing the Markdown body content.

The best way to test multiline description normalization in markdown is to run a validation unit that verifies multiline YAML descriptions convert to single lines and checks the Markdown body for operational instructions.

Markdown YAML frontmatter does not properly support multiline descriptions without normalization, requiring conversion to single lines to ensure correct parsing and display within the Markdown body.