Skip to content

Add blank lines above pattern labels so GitHub renders them separately - #329

Merged
blader merged 1 commit into
mainfrom
fix-skill-line-breaks
Nov 10, 2026
Merged

blader merged 1 commit into
mainfrom
fix-skill-line-breaks

Conversation

@blader

@blader blader commented Nov 10, 2026

Copy link
Copy Markdown
Owner

Why

On GitHub, SKILL.md shows its patterns wrong. GitHub joins adjacent lines into one paragraph, so each "Watch for" runs into the "Problem" below it. A line directly under a quote becomes part of that quote, so every "After" label, and each later "Before" label, appears inside the quote above it.

What changed

SKILL.md gets a blank line above each "Watch for", "Rule", "Problem", "Before", and "After" label that sat directly under other text. That is 99 added lines. No wording changed, and the file stays at 5,316 words. CHANGELOG.md gets a note under Unreleased.

A label followed directly by its quote is left alone, because GitHub already renders that as a paragraph and then a quote.

This is a formatting change only. The decision for the reviewer is whether blank lines are the right fix. The alternative, two trailing spaces at the end of each line, would not stop a label from joining the quote above it.

Validation

I rendered SKILL.md with GitHub's Markdown API before and after the change and counted the labels in the HTML:

Before After
Labels rendered inside a quote 52 0
Paragraphs holding two or more labels 37 0
Separate quotes 28 80

python3 scripts/validate-package.py, npx --yes skills@1.5.20 add . --list, and claude plugin validate . pass.

To check it, open SKILL.md on this branch and look at pattern 1. "Watch for", "Problem", each "Before", and each "After" should sit on their own lines, with only the example text inside the quotes.

#318 edits lines next to these, so it will need a rebase after this merges.

🤖 Generated with Claude Code

https://claude.ai/code/session_01MfuoZmv32PFqiaYKaAVSFc

GitHub joins adjacent lines into one paragraph, so "Watch for" and
"Problem" ran together, and each "After" label was pulled into the
quote above it. A blank line above each label ends the paragraph or
the quote. No wording changed; SKILL.md stays at 5,316 words.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MfuoZmv32PFqiaYKaAVSFc
@blader
blader merged commit 6042f31 into main Nov 10, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant