
Em Dash Expert
OfficialFreeMaster the em dash for clear, precise writing.
Free · Opens the source repo
What Em Dash Expert does
The Em Dash Expert skill is designed for developers and writers who want to ensure proper punctuation in their code comments and data files. This skill focuses on the em dash, a punctuation mark that has a rich history and specific usage rules. While the em dash is often celebrated in literary contexts for its ability to convey pauses and interruptions, this skill emphasizes that it should never be used in programming or technical writing. Instead, it advocates for the use of the hyphen (-) as a replacement, ensuring clarity and consistency in code documentation.
The skill provides a comprehensive overview of the em dash's history, tracing its evolution from handwritten manuscripts to modern digital formats. It highlights the importance of understanding punctuation in the context of code, where clarity is paramount. By using this skill, users can avoid common pitfalls associated with punctuation misuse in programming environments, thereby improving the readability of their code comments and documentation.
Additionally, the Em Dash Expert skill includes practical commands for replacing em dashes and en dashes with hyphens in text files. This functionality is particularly useful for developers who may encounter these punctuation marks in legacy code or comments. By automating this process, the skill helps maintain coding standards and reduces the likelihood of confusion caused by improper punctuation.
Overall, this skill is ideal for anyone involved in coding or technical writing who seeks to enhance their understanding of punctuation and improve the quality of their documentation. It serves as a valuable reference for ensuring that comments and data files adhere to best practices in punctuation usage.
When to use it
Use this skill when writing or reviewing code and comments to ensure proper punctuation.
When not to use it
This skill is not suitable for creative writing or contexts where em dashes are appropriate.
What you can build with it
Code Review
During a code review, use this skill to ensure all comments are free of em dashes, replacing them with hyphens for clarity.
Documentation Writing
When writing technical documentation, apply this skill to maintain consistent punctuation standards throughout your files.
Legacy Code Cleanup
Use this skill to clean up legacy code comments that may contain em dashes, ensuring they conform to modern standards.
How to install Em Dash Expert
View source1. Install with the skills CLI
npx skills add github/awesome-copilot/em-dash --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by githubem 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:
setlocal enabledelayedexpansion && set "_a=a" && echo !_a! && endlocal
- Example:
- Keyboard character:
Pauses and Clause Connectors
These marks control the rhythm of your writing and connect different ideas:
- Comma
,: Used to separate items in a list, link independent clauses with a conjunction (e.g., and, but), or set off introductory phrases- Keyboard character:
true - Programming language syntax:
true- Example:
fn(a, b)
- Example:
- Keyboard character:
- Semicolon
;: Connects two closely related independent clauses that could stand alone as separate sentences- Keyboard character:
true - Programming language syntax:
true- Example:
var foobar = "foo-bar";
- Example:
- Keyboard character:
- Colon
:: Introduces a list, a quote, or an explanation. The text preceding a colon must be a complete sentence- Keyboard character:
true - Programming language syntax:
true- Example:
{"age": 26}
- Example:
- Keyboard character:
Words, Quotations, and Possessions
- Apostrophe
': Indicates possession (e.g., Sarah's book) or represents missing letters in a contraction (e.g., I'll instead of I will)- Keyboard character:
true - Programming language syntax:
true- Example:
char letter = 'A';
- Example:
- Keyboard character:
- Quotation Marks
": Enclose direct speech or quotes. In American English, periods and commas almost always go inside the quotation marks- Keyboard character:
true - Programming language syntax:
true- Example:
char abc[] = "abc";
- Example:
- Keyboard character:
Dashes and Slashes
- Hyphen
-: Joins two or more words together to form a single compound adjective (e.g., well-known)- Keyboard character:
true - Programming language syntax:
true- Example:
count--
- Example:
- Keyboard character:
- En dash (U+2013,
\u2013) and em dash (U+2014,\u2014):- The en dash is the thinner of the two, and is used to show numerical ranges
or connections between words in a compound adjective when one element is itself
multiple words
- Keyboard character:
false - Programming language syntax:
false
- Keyboard character:
- The em dash is wider, and is used to note a break, provide drama, or give an example.
- Keyboard character:
false - Programming language syntax:
false
- Keyboard character:
- The en dash is the thinner of the two, and is used to show numerical ranges
or connections between words in a compound adjective when one element is itself
multiple words
- Slash
/: Indicates a choice (e.g., yes/no) or separates lines of poetry- Keyboard character:
true - Programming language syntax:
true- Example:
/* comment */ || 10/2 || 5//2
- Example:
- Keyboard character:
Grouping and Emphasizing
- Parentheses
( ): Enclose extra, non-essential information that clarifies a sentence but can be removed without changing the core meaning- Keyboard character:
true - Programming language syntax:
true- Example:
if (5 > 2)
- Example:
- Keyboard character:
- Brackets
[ ]: Used to enclose words added to a quotation by someone other than the original author, usually to clarify a pronoun or provide missing context- Keyboard character:
true - Programming language syntax:
true- Example:
var arr = [1, 2, 3];
- Example:
- Keyboard character:
General Rule for using Other Punctuation Characters
When commenting on code files, or any file that will be included in compiled computer instructions; use this rule-of-thumb:
-
Determine if the character is commonly on a keyboard, or is the punctuation character part of a programming language's syntax:
- If NOT a keyboard character, and NOT a common programming syntax
character; then:
- NEVER use that character in code or code comments
- Example not mentioned:
�
- Example not mentioned:
- NEVER use that character in code or code comments
- If a keyboard character, and a common programming syntax character, then:
- Use that character correctly in code comments
- If NOT a keyboard character, and NOT a common programming syntax
character; then:
[!IMPORTANT] When in doubt, follow the pseudo-code instructions below:
# For en dash and em dash
echo - | sed "s/-/-/g"
# Replace Unicode en dash (U+2013) and em dash (U+2014) with hyphen-minus (-)
perl -CS -pe 's/\x{2013}|\x{2014}/-/g'
# For encoded characters
echo � | sed "s/�/ /g"
# (Optional) Remove the Unicode replacement character (U+FFFD) if it appears in pasted text
perl -CS -pe 's/\x{FFFD}/ /g'
Further Reading
Frequently asked questions about Em Dash Expert
Similar skills
Supabase Docs Authoring
Streamline your Supabase documentation process.
Docs Writer
Streamline your documentation process with precision.
Clinical Case Report
Generate structured medical case presentations.
CrossFrame Suite
Streamline complex workflows for Chinese structural analysis.
Nature Statistics Reporting
Enhance manuscript statistics for high-impact journal submissions.
Venue Templates
Streamline your academic document preparation with ease.
