skills/em-dash/SKILL.md
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.
npx skillsauth add williamlimasilva/.copilot em-dashInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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'
development
Anxiety-aware, evidence-driven collaboration for stalled or high-stakes work when a user says uncertainty, repeated setbacks, or lack of visible progress is causing significant anxiety or distress. Use immediately when explicitly invoked; when this fit is only inferred from the user's own account, ask permission before applying it. Preserve the user's ideal and turn grounded perspective-taking into persistent, bounded problem solving. Do not use to diagnose, provide therapy, manufacture certainty, or lower goals for reassurance.
development
Build, review, debug, package, and test Roslyn diagnostic analyzers, code fix providers, and incremental source generators. Use for DiagnosticAnalyzer, CodeFixProvider, IIncrementalGenerator, IOperation analysis, Microsoft.CodeAnalysis dependency pinning, Roslyn test harnesses, C#/VB tests, and analyzer NuGet packaging.
testing
Migrates a project that uses checked-in .designer.cs files behind .resx to using a source-generator instead
development
Polish any GitHub repository's surface — labels (emoji rating tiers, P0–P3 priority, impact severity), issue forms, PR template, CI workflows, CODEOWNERS, rulesets, docs. Repo meta & config only — no code logic touched. Use when creating a new repo or polishing an existing one.