yaml-jazz
YAML is sheet music. The LLM is the jazz musician. Comments are soul.
npx skills add majiayu000/claude-skill-registry --skill yaml-jazz-simhacker-moollm-2 --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# YAML Jazz > *"YAML is sheet music. The LLM is the jazz musician. Comments are soul."* --- ## What Is It? **YAML Jazz** is how MOOLLM treats structured data: not as rigid schemas, but as **semantic improvisation** where: > *"The source is the destination."* > — The Markdown/YAML principle - **Structure carries meaning** — indentation, ordering, grouping - **Comments ARE data** — they're guidance, context, soul - **The LLM interprets** — filling gaps, resolving ambiguity, inferring intent - **Schemas are suggestions** — starting points, not prisons ```yaml # This comment is NOT ignored! # It tells the LLM: "be gentle with this section" user_preferences: theme: dark # they mentioned eye strain font_size: 16 # ← bump this if they complain again ``` --- ## Core Principles ### Comments Matter ```yaml # CRITICAL: Do not modify without user approval api_key: ${SECRET} # TODO: migrate to new format after v2 launch legacy_format: true # keeping for backwards compat ``` The LLM reads these. Acts on them. **Comments are instructions.** ### Structure Is Semantic ```yaml # Priority by position (first = most important) tasks: - Fix authentication bug # P0 - Update documentation # P1 - Refactor
- What Is It?
- Core Principles
- Comments Matter
- Structure Is Semantic
- Improvise Within Constraints
- The Jazz Metaphor
- When to Use
- Empirical Evidence: Entropy Collapse
- The Discovery (April 2025)
- Why JSON Hurts LLMs
- Why YAML Helps LLMs
- Sunil's Simplified Schema
- The Insight
- The "Source is Destination" Principle
What does the yaml-jazz skill do?
YAML is sheet music. The LLM is the jazz musician. Comments are soul.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill yaml-jazz-simhacker-moollm-2 --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.