Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions skills/write-prose/references/NATURAL-PROSE-REVIEW.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ Inspect the piece for:
- a generic opening that delays the actual subject;
- vague claims, missing examples or detail that cannot be inspected;
- repeated words, claims, sentence openings, transitions or conclusions;
- clustered or habitual em dashes that flatten their distinctive pause;
- any em dash that could become a comma, full stop, colon, semicolon or parentheses, especially when more than one appears;
- paragraphs with conspicuously uniform length or function;
- repeated balanced clauses or triads;
- inflated vocabulary, needless intensifiers or a register more complex than the reader needs;
Expand All @@ -17,4 +17,4 @@ Inspect the piece for:

Correct the underlying problem. Add specificity instead of decorative variation. Compress repetition instead of swapping synonyms. Change rhythm where thought and emphasis change. Preserve deliberate parallelism, repetition, technical vocabulary and genre conventions when they serve the piece.

Keep an em dash only when its interruption or aside works better than quieter punctuation. Let contractions, sentence lengths and word strength follow meaning and register.
Default to no em dashes. Keep one only when a rare, strong interruption is clearer than quieter punctuation, and rewrite if more than one appears unless each is essential. Let contractions, sentence lengths and word strength follow meaning and register.
1 change: 1 addition & 0 deletions skills/write-prose/references/PREFERRED-VOICE.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ Use a **professional but conversational** voice. Sound like a capable person exp
- Use plain language without removing necessary technical substance. Define unfamiliar terms where the reader meets them.
- Use first person for real choices, actions, experience and uncertainty supplied by the caller. Use ordinary contractions when the genre permits them.
- Keep paragraphs focused and transitions meaningful. Vary connectors rather than repeatedly announcing every example, contrast or conclusion.
- Prefer commas, full stops, colons or parentheses to em dashes. Most pieces should contain none; use one only in the rare case that a strong interruption is clearer than quieter punctuation.
- Admit a limitation directly and follow it with what it changes.
- Finish practically. Prefer a conclusion, implication, recommendation or next step to a broad flourish.

Expand Down
2 changes: 1 addition & 1 deletion skills/write-prose/references/WRITING-TECHNIQUES.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,4 +30,4 @@ Treat these as available tools. Choose a technique because of the job it perform
- **Numbers:** Use for sequence, rank or a fixed count.
- **Prose:** Keep connected reasoning in sentences and paragraphs when relationships and qualification matter more than item retrieval.

Use punctuation to show relationships and pace. A full stop can isolate a conclusion, a colon can introduce an explanation and a semicolon can hold close independent clauses together. Use an em dash sparingly for a distinct interruption or aside; when several appear, check whether full stops, commas, colons or parentheses express the relationships better.
Use punctuation to show relationships and pace. A full stop can isolate a conclusion, a colon can introduce an explanation and a semicolon can hold close independent clauses together. Choose the quietest mark that makes the relationship clear.
Loading