Skip to content

Instantly share code, notes, and snippets.

@lukebussey
Created February 26, 2026 20:19
Show Gist options
  • Select an option

  • Save lukebussey/8b2bb6d056437a868537f2748e8548b2 to your computer and use it in GitHub Desktop.

Select an option

Save lukebussey/8b2bb6d056437a868537f2748e8548b2 to your computer and use it in GitHub Desktop.
Punctuation Skill
name description
punctuation
Converts straight quotes to typographic quotes, normalizes hyphens/dashes and ellipsis in prose copy. Use when editing marketing copy, blog posts, landing pages, docs, or when the user asks to fix quotation marks, dashes, or ellipsis.

Punctuation

Goal

Convert straight quotes, hyphens/dashes, and ellipsis to correct typographic characters in prose. Do not change code blocks, inline code, commands, or file paths unless explicitly requested.

Always write the actual Unicode characters (e.g. , , , -, , ) directly in the file. Never use Unicode escape sequences like \u201C or \u2019.

YAML frontmatter

Do not apply typography to YAML syntax (keys, delimiters, or structural quotes). Apply typography only to the text content inside frontmatter values—e.g. title, description, excerpt.

Rules

Quotes

  1. Double quotes: " → opening and closing
  2. Single quotes/apostrophes: ' — contractions (e.g. don’t, it’s), possessives (e.g. company’s, platforms’)
  3. Standalone quoted text: 'Simple'‘Simple’

Hyphens and dashes

  1. Hyphen -: compound words (e.g. well-known, high-converting)
  2. En dash : ranges (e.g. 2024–2026, pages 10–20)
  3. Em dash : sentence breaks, interruptions, parenthetical asides. Use unspaced (US style): word—word

Ellipsis

  1. Replace ... with the ellipsis character in prose

Examples

  • "Fast setup"“Fast setup”
  • it'sit’s
  • platforms'platforms’
  • He said, "it's done."He said, “it’s done.”
  • Q1–Q4Q1–Q4
  • 2020–20252020–2025
  • This is important - really important.This is important—really important.
  • Wait... there's more.Wait… there’s more.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment