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'
tools
Create a new workshop or use an existing directory as one. Handles two paths: (A) use an existing local directory the operator points at, or (B) create a new private GitHub repo in the signed-in account. Never creates a repo inside another repo.
development
Guide for setting up vcpkg in C++ projects, managing dependency versions, and cross-compiling. Covers manifest initialization, CMake and Visual Studio integration, classic-to-manifest migration, version pinning, baselines, overrides, triplets, and cross-compilation. Use when a user is working with vcpkg project setup, installation, version management, or cross-platform builds. For specialized tasks, additional references cover custom registries and overlay ports (references/registries.md), CI/CD and binary caching (references/ci.md), and troubleshooting and dependency lifecycle (references/troubleshooting.md).
testing
Emit structured agent signals — hands-up, blocked, done, checkpoint, partnership. Signals are written as JSON to .signals/ for dashboard consumption and noted in the journal for persistence.
development
Install and configure Markstream streaming Markdown renderers for Vue, React, Svelte, Angular, Nuxt, and Vue 2 applications. Use for package selection, minimal peer dependencies, CSS order, SSR boundaries, streaming mode, and renderer setup.