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.
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:
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.
Never.
[!IMPORTANT] Never. In no way, shape, form, or fashion is tone ever important in code comments.
- (hyphen) character instead- (hyphen) character[!NOTE] Default to never
As part of being an em dash expert comes the knowledge of other punctuation marks or characters.
Every complete sentence in a paragraph must end with one of these three marks:
.: Ends statements and declarative sentences
truetrue
<?php echo "a" . "b" . "c"; ?>?: Ends direct questions
truetrue
condition ? expression_if_true : expression_if_false!: Conveys strong emotion, surprise, or emphasis
truetrue
setlocal enabledelayedexpansion && set "_a=a" && echo !_a! && endlocalThese marks control the rhythm of your writing and connect different ideas:
,: Used to separate items in a list, link independent clauses with a
conjunction (e.g., and, but), or set off introductory phrases
truetrue
fn(a, b);: Connects two closely related independent clauses that could
stand alone as separate sentences
truetrue
var foobar = "foo-bar";:: Introduces a list, a quote, or an explanation. The text preceding
a colon must be a complete sentence
truetrue
{"age": 26}': Indicates possession (e.g., Sarah's book) or represents
missing letters in a contraction (e.g., I'll instead of I will)
truetrue
char letter = 'A';": Enclose direct speech or quotes. In American English,
periods and commas almost always go inside the quotation marks
truetrue
char abc[] = "abc";-: Joins two or more words together to form a single compound
adjective (e.g., well-known)
truetrue
count--\u2013) and em dash (U+2014, \u2014):
falsefalsefalsefalse/: Indicates a choice (e.g., yes/no) or separates lines of poetry
truetrue
/* comment */ || 10/2 || 5//2( ): Enclose extra, non-essential information that clarifies a
sentence but can be removed without changing the core meaning
truetrue
if (5 > 2)[ ]: Used to enclose words added to a quotation by someone other
than the original author, usually to clarify a pronoun or provide missing context
truetrue
var arr = [1, 2, 3];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:
�[!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'
Copy a source-pinned command for your client. You run it yourself.
Destination: .claude/skills/em-dash · pinned to the source commit
# Run from your project root
git clone https://github.com/github/awesome-copilot.git .skillboard-tmp
git -C .skillboard-tmp checkout f11a4e441c5ff061b4f8ae37952be8c602e4034e
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/skills/em-dash" ".claude/skills/"
rm -rf .skillboard-tmpReview the source before running. This copies files into your project; it is not a one-click install and does not verify runtime safety.
sudo apt update && sudo apt install -y gitnpm install -g @anthropic-ai/claude-code# Run from your project root
git clone https://github.com/github/awesome-copilot.git .skillboard-tmp
git -C .skillboard-tmp checkout f11a4e441c5ff061b4f8ae37952be8c602e4034e
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/skills/em-dash" ".claude/skills/"
rm -rf .skillboard-tmpDestination: .claude/skills/em-dash
Scanner static-checks@0.1.0 · commit f11a4e441c5f. Static checks cannot prove runtime safety – review the source and the exact diff before installing. How checks work.
No static rules matched. This is not a safety guarantee.