em-dash
Helps your agent understand and correctly use the em dash. It ensures punctuation is used appropriately in comments and files, replacing em dashes with hyphens.
What it does
This tool understands the history and correct use of the em dash. It ensures you use a hyphen (-) instead of an em dash in code, comments, or data files, as the em dash is not suitable for these contexts.
When to use it
- ✓When writing code comments.
- ✓When reviewing data files.
- ✓When you want to ensure only hyphens (-) are used in technical text.
Example of what to ask your AI
“Replace all em dashes in this code comment with hyphens: // Use an em dash here for a pause.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
The tool knows that em dashes should not be used in code or data. It replaces any found em dashes with a hyphen (-), which is the appropriate character for these situations.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add github/awesome-copilot --skill em-dashOr download just the file:
curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/em-dash/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
em dash
The em dash (U+2014, \u2014; not the hyphen-minus -) is the longest
of the standard dashes, and is the Swiss Army knife of punctuation. Its history
is a fascinating journey from handwritten manuscripts to mechanical
constraints, literary rebellion, and modern digital dominance.
Here is a breakdown of how the em dash evolved:
History of the em dash
Early Beginnings (15th-18th Century)
- The First Dashes: Early appearances of the dash in English literature date back to 1580 in private letters and 1588 in English drama. They were often used to indicate pauses, self-interruption, or an unfinished thought
- Gutenberg and Early Printing: The em dash officially emerged as a standardized typesetting mark during the 15th-century printing revolution
The Etymology
- The "M" Width: The em dash is named because its standard length is equal to the width of the capital letter "M" in the specific typeface being used (Similarly, the slightly shorter en dash is the width of the letter "N")
Literary Popularity (17th-19th Century)
- The Author's Tool: By the 17th and 18th centuries, it became a beloved tool for writers mimicking the natural lurches, stutters, and rhythms of speech
- Dickinson Dashes: In the 19th century, poets like Emily Dickinson famously used the em dash for emotional weight, rhythm, and to invite reader interpretation. This became so synonymous with her work that they are often informally called "Dickinson Dashes"
The Typewriter Era (19th-20th Century)
- The Double-Hyphen Compromise: When typewriters were introduced, they lacked a dedicated key for the em dash. To compensate, typists began using two consecutive hyphens (--)
- The No-Space Rule: Because of this mechanical compromise, a stylistic convention of typing the mark without surrounding spaces emerged and remains
The Digital Age (Present Day)
- Return to Form: Modern digital typesetting and word processing programs have restored the true, unbroken em dash
- Modern Renaissance: The em dash is experiencing a resurgence of popularity
- It has become a hallmark of modern long-form prose and is also a favorite, heavily used punctuation mark in AI outputs, which often prioritize a conversational, stream-of-consciousness style
Speculation for em Dash Modern Renaissance
- Professional authors who had to meet deadlines and did not have the time to strictly proofread the online article before submitting it
- Professionals who wanted to show off their knowledge of HTML encoding in order to seem smart
- Graphic designers who wanted to make the visual composition of text on a web page more appealing
- The fact that popularity begets popularity
- People publishing web articles saw that everyone else was using em dashes, so instead of using a hyphen where one belonged, they opted to use an em dash
Analysis of em dash History
Nowhere in the history of the em dash was it intentionally used in the writing of computer code, or files meant to be executed as computer instructions.
When to use em or en dashes
Never.
In Code Files
[!IMPORTANT] Never. In no way, shape, form, or fashion is tone ever important in code comments.
- Never
- Use the
-(hyphen) character instead - If working as an agent, and an em dash is in a comment, then replace it
with the
-(hyphen) character
- Use the
In Raw Data and/or Text Files
[!NOTE] Default to never
- When instructed to, and it is 100% clear that the text is to be used as:
- Literature
- News
- If working as an agent, and an em dash is already part of the data, then leave it
Other Punctuation Characters
As part of being an em dash expert comes the knowledge of other punctuation marks or characters.
End-of-Sentence Marks
Every complete sentence in a paragraph must end with one of these three marks:
- Period
.: Ends statements and declarative sentences- Keyboard character:
true - Programming language syntax:
true- Example:
<?php echo "a" . "b" . "c"; ?>
- Example:
- Keyboard character:
- Question Mark
?: Ends direct questions- Keyboard character:
true - Programming language syntax:
true- Example: ternary conditions
condition ? expression_if_true : expression_if_false
- Example: ternary conditions
- Keyboard character:
- Exclamation Point
!: Conveys strong emotion, surprise, or emphasis- Keyboard character:
true - Programming language syntax:
true- Example:
- Keyboard character:
…
FAQ
What is an em dash?
It's a punctuation mark longer than a hyphen, used in literary writing to indicate pauses or emphasis.
Why shouldn't I use em dashes in code?
Em dashes are not standard characters in many programming languages and can cause errors. The hyphen (-) is the correct character for these contexts.
What should I do if I find an em dash in a data file?
If the text is clearly for reading (like literature or news), leave the em dash. Otherwise, especially in technical contexts, replace it with a hyphen.
Details
Original description by the author
Expert on the history, origin, and correct use of the em dash. Use when writing or reviewing code, comments, or data files to avoid em and en dashes, defaulting to never using them and replacing any found with a hyphen (-). Includes strong knowledge of punctuation marks and the proper usage of punctuation characters when writing comments.
repo: github/awesome-copilot
Popularity
- GitHub stars
- 40k
- Ranking position
- #5131
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
acquire-codebase-knowledge
Helps your agent understand and document an existing code project. It's useful for onboarding new people or getting an overview of the architecture.
github/awesome-copilot
acreadiness-assess
Enables your agent to assess a project's readiness for AI and generate a report. It's useful for understanding how well a project is prepared to use AI tools.
github/awesome-copilot
acreadiness-generate-instructions
Helps your agent create instructions for AI tools based on an assessment. It's useful for improving how AI interacts with code and closing identified gaps.
github/awesome-copilot
acreadiness-policy
Enables your agent to help define or apply policies for AI project assessment. It's useful for standardizing how projects are evaluated and ensuring compliance.
github/awesome-copilot
Similar skills
intent-driven-development
Helps your agent turn ideas into clear, testable plans. Defines criteria to ensure changes are made correctly and safely.
affaan-m/ECC
product-capability
Guides your agent in turning product ideas into clear plans. It defines what needs to be done, the limits, and decisions before development.
affaan-m/ECC
article-writing
Writes long-form content like articles, guides, and blog posts with a unique style. It's useful when you need well-written texts with a consistent voice and credibility.
affaan-m/ECC