folded-desc-skill

Parses YAML folded scalar descriptions for normalization in Markdown tables.

1.3k|146|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/first-fluke/oh-my-agent --skill folded-desc-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: folded-desc-skill
Source: https://github.com/first-fluke/oh-my-agent/tree/main/cli/platform/emit/__fixtures__/repo/.agents/skills/folded-desc-skill
Command: npx skills add https://github.com/first-fluke/oh-my-agent --skill folded-desc-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

YAML folded scalars in skill descriptions can embed trailing newlines that break Markdown table rendering, and this fixture demonstrates how such descriptions are parsed and normalized.

Core Features & Use Cases

  • Folded Scalar Parsing: Handles YAML descriptions written with the folded scalar style (>) that span multiple lines.
  • Newline Normalization: Illustrates the need to strip embedded trailing newlines before inserting descriptions into Markdown tables.
  • Use Case: When generating a catalog table of skills from their frontmatter, descriptions using folded scalars must be normalized so the table rows render correctly.

Quick Start

Ask the agent to parse this skill's frontmatter and render its description as a single-line entry in a Markdown table.

Frequently Asked Questions about folded-desc-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I parse a YAML folded scalar in frontmatter?

Use any standard YAML parser to read the frontmatter; folded scalars (>) are automatically collapsed into a single string with spaces replacing line breaks. The result may retain a trailing newline that needs trimming.

Why does my Markdown table break with YAML descriptions?

Folded scalar descriptions can include an embedded trailing newline, which splits the table row when inserted into Markdown. Normalize the string by trimming whitespace and newlines before rendering.

What is the difference between folded and literal YAML scalars?

Folded scalars (>) replace line breaks with spaces, while literal scalars (|) preserve line breaks exactly. Both may leave a trailing newline that should be stripped before use in single-line contexts.

How do I normalize multi-line YAML strings for tables?

Trim leading and trailing whitespace, replace internal newline characters with spaces, and collapse repeated spaces. This produces a single-line string safe for Markdown table cells.