Gsd-skill-creator expository-writing

Expository and argumentative prose techniques for nonfiction. Covers essay structure (thesis-driven, exploratory, lyric), argumentation (claim-evidence-reasoning, counterargument, concession, Toulmin model), paragraph architecture (topic sentences, development, transitions, coherence), clarity and precision (Orwell's six rules, plain language, jargon management), research integration (source synthesis, attribution, paraphrase vs. quotation), and nonfiction forms (personal essay, op-ed, critical review, academic paper, reported piece). Use when writing nonfiction prose, constructing arguments, or analyzing expository structure.

install
source · Clone the upstream repo
git clone https://github.com/Tibsfox/gsd-skill-creator
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/Tibsfox/gsd-skill-creator "$T" && mkdir -p ~/.claude/skills && cp -r "$T/examples/skills/writing/expository-writing" ~/.claude/skills/tibsfox-gsd-skill-creator-expository-writing && rm -rf "$T"
manifest: examples/skills/writing/expository-writing/SKILL.md
source content

Expository Writing

Exposition is writing that explains, argues, or analyzes. It is the dominant mode of intellectual life -- the essay, the article, the review, the report, the academic paper. Unlike narrative, which organizes experience through story, exposition organizes ideas through logic. The essay is not a lesser form than fiction; it is a different technology of thought. James Baldwin called the essay "the personal voice engaged with a public issue." George Orwell called it "the attempt to find out what you really think." This skill covers structure, argumentation, clarity, research integration, and the major nonfiction forms.

Agent affinity: orwell (clarity, argumentation), baldwin (essay, moral voice), calkins (process pedagogy)

Concept IDs: writ-close-reading, writ-textual-evidence, writ-thematic-analysis, writ-revision-strategies

Part I -- Essay Structure

Thesis-Driven Essay

The classical form: state a claim, support it with evidence, address counterarguments, conclude. The thesis is the spine. Every paragraph exists to advance, support, or qualify it.

The thesis statement. A thesis is not a topic ("this essay is about climate change") or an announcement ("I will discuss three reasons"). A thesis is a claim that a reasonable person could disagree with: "Carbon pricing is the most effective policy lever for reducing industrial emissions because it aligns private incentives with public costs."

Structure:

  1. Introduction: context, significance, thesis statement.
  2. Body paragraphs: each develops one aspect of the argument.
  3. Counterargument and concession: the strongest objection, honestly stated, then addressed.
  4. Conclusion: restatement in light of the argument's development, implications, next questions.

Exploratory Essay

The essay as inquiry. Montaigne's form -- "essai" means "attempt" or "trial." The writer does not begin with a thesis but with a question, and the essay traces the process of thinking it through. The conclusion may be provisional, contradictory, or honestly uncertain.

When to use. When the question is genuinely open and the writer's intellectual honesty is more valuable than a forced conclusion. Baldwin's "Notes of a Native Son" is exploratory -- it does not resolve the contradictions between love and rage, father and country. It holds them in tension.

Lyric Essay

A hybrid form that borrows techniques from poetry and narrative -- fragmentation, white space, image-driven logic, associative rather than linear structure. The lyric essay argues through juxtaposition rather than syllogism.

When to use. When the subject resists linear treatment -- trauma, memory, identity, landscape. The form should match the content's emotional logic.

Part II -- Argumentation

Claim-Evidence-Reasoning (CER)

The fundamental unit of argument:

Claim: The assertion you are making. Evidence: The specific data, quotation, example, or fact that supports the claim. Reasoning: The explanation of how the evidence supports the claim -- the inferential bridge the reader needs.

Evidence without reasoning is a pile of facts. Reasoning without evidence is speculation. Both must be present.

The Toulmin Model

Stephen Toulmin's model provides finer resolution than CER:

ComponentRoleExample
ClaimThe conclusion being argued for"Universal basic income would reduce poverty"
DataEvidence supporting the claim"Pilot programs in Finland and Kenya showed..."
WarrantThe principle connecting data to claim"What works in controlled pilots can scale nationally"
BackingSupport for the warrant itself"Historical precedents: Social Security, minimum wage"
QualifierLimits on the claim's scope"In economies with adequate tax bases"
RebuttalConditions under which the claim fails"Unless inflation absorbs the income transfer"

The Toulmin model is particularly useful for analyzing arguments that seem convincing but have hidden warrants -- unstated assumptions that, once surfaced, may not hold.

Counterargument and Concession

The strongest argument anticipates and addresses objections. Ignoring the best counterargument makes the writer appear either uninformed or dishonest.

Structure:

  1. State the counterargument fairly -- use the strongest version (steelman, not strawman).
  2. Concede what is valid in it.
  3. Explain why the original claim survives despite the concession.

Orwell's standard. In "Politics and the English Language," Orwell argues that intellectual dishonesty begins with linguistic dishonesty. A writer who cannot state the opposing view clearly has not understood the issue well enough to write about it.

Part III -- Paragraph Architecture

Topic Sentences

A topic sentence states the paragraph's controlling idea. Not every paragraph needs an explicit topic sentence, but every paragraph needs a controlling idea -- a single point that the paragraph develops. If a paragraph cannot be summarized in one sentence, it is doing too much.

Development Patterns

PatternStructureUse when
ExampleTopic sentence + specific instancesThe reader needs concrete evidence
ExplanationTopic sentence + analysis of why/howThe reader needs reasoning, not just facts
ComparisonPoint-by-point or blockTwo subjects illuminate each other
ProcessSequential stepsThe reader needs to understand how something works
DefinitionExtended exploration of a termA key concept is contested or unfamiliar

Transitions

Transitions are not decorative connectives ("furthermore," "moreover," "in addition"). They are logical signals that tell the reader the relationship between ideas: continuation, contrast, cause, consequence, concession, qualification. The best transitions are built into the sentence structure rather than bolted on as adverbs.

Weak: "Furthermore, Baldwin argues that race shapes American identity." Strong: "Baldwin extends this argument to its most uncomfortable implication: race does not merely affect American identity -- it constitutes it."

Coherence

A coherent paragraph moves in one direction. The known-new contract: each sentence begins with information the reader already has (the "known") and ends with new information that advances the paragraph. When sentences violate this contract -- when the new information has no connection to what came before -- the paragraph feels disjointed.

Part IV -- Clarity and Precision

Orwell's Six Rules

From "Politics and the English Language" (1946):

  1. Never use a metaphor, simile, or other figure of speech which you are used to seeing in print.
  2. Never use a long word where a short one will do.
  3. If it is possible to cut a word out, always cut it out.
  4. Never use the passive where you can use the active.
  5. Never use a foreign phrase, a scientific word, or a jargon word if you can think of an everyday English equivalent.
  6. Break any of these rules sooner than say anything outright barbarous.

Rule 6 is the most important. The other five are heuristics, not laws. A writer who follows rules 1-5 mechanically will produce flat, stripped prose. A writer who understands their purpose -- to fight the gravitational pull of cliche, inflation, and evasion -- will produce clear, honest prose.

Plain Language Principles

  • Prefer concrete nouns to abstract ones. "The committee decided" not "a decision was reached."
  • Prefer active voice for clarity, passive voice for emphasis on the receiver.
  • Front-load sentences with the main point; qualifications follow.
  • One idea per sentence. One point per paragraph.
  • Define technical terms on first use.

Jargon Management

Every field has specialized vocabulary. Jargon is not inherently bad -- it is precise communication within a community. It becomes a problem when it substitutes for thought ("leverage synergies to ideate value-add solutions") or excludes readers unnecessarily. The test: could this sentence be understood by an intelligent reader outside the field? If not, and if the audience includes such readers, translate.

Part V -- Research Integration

Source Synthesis

Synthesis means putting sources in conversation with each other, not presenting them sequentially. A paragraph that says "Smith argues X. Jones argues Y. Lee argues Z." is a list, not synthesis. Synthesis would be: "While Smith and Jones agree that X drives the phenomenon, they diverge on mechanism: Smith attributes it to A, Jones to B. Lee's longitudinal data suggests both are partially correct but that the dominant factor shifts over time."

Paraphrase vs. Quotation

Paraphrase when the idea matters more than the exact words. Paraphrase is not rearranging the original's sentence structure -- it is expressing the idea in your own conceptual framework.

Quote when the exact language matters -- when the phrasing is distinctive, when the authority of the original voice strengthens the argument, or when you are analyzing the language itself.

The quote sandwich: context (who said this and why) -> quotation -> analysis (what it means for your argument). Never drop a quotation into a paragraph without framing and interpretation.

Attribution

Every claim that is not common knowledge or your own original analysis requires attribution. The standard is not "did I copy words?" but "did this idea originate with me?" Failing to attribute ideas -- even when paraphrased in original language -- is intellectual dishonesty.

Part VI -- Nonfiction Forms

Personal Essay

The writer's experience as lens for a larger question. Baldwin's "Notes of a Native Son" uses his father's death and a race riot to examine rage and love in Black American life. The personal essay is not confession; it is experience rendered as argument.

Op-Ed / Commentary

Opinion writing for public audiences. 600-800 words. Clear thesis in the first paragraph. One or two strong supporting points. A specific call to action or reframing. The constraint of brevity forces precision.

Critical Review

Analysis of a work (book, film, performance, product). A review is not a summary -- it is an argument about the work's achievement, significance, or failure. The reviewer's job is to help the reader decide whether to engage with the work and to deepen the reader's understanding of it.

Academic Paper

Formal argumentation within a disciplinary framework. Abstract, introduction, literature review, methods, results, discussion, conclusion. The conventions exist to enable peer evaluation and replication. Writing within the form does not mean writing badly -- the best academic prose is clear, precise, and readable.

Reported Piece

Journalism and long-form nonfiction built on original reporting. The writer is not arguing from personal experience but from evidence gathered through interviews, observation, document analysis, and data. Joan Didion, Ta-Nehisi Coates, and Katherine Boo work in this form.

Cross-References

  • orwell agent: Clarity, argumentation, Orwell's six rules. Primary agent for expository writing tasks.
  • baldwin agent: The essay as truth-telling, moral voice, public intellectual writing.
  • calkins agent: Process pedagogy, workshop conferencing, scaffolded essay writing.
  • research-writing skill: Academic and research-specific writing conventions.
  • revision-editing skill: How expository structures are tightened through revision.
  • voice-style skill: How authorial voice functions in nonfiction.

References

  • Orwell, G. (1946). "Politics and the English Language." Horizon.
  • Baldwin, J. (1955). Notes of a Native Son. Beacon Press.
  • Montaigne, M. de (1580). Essais. Trans. Frame, 1958. Stanford University Press.
  • Toulmin, S. (1958). The Uses of Argument. Cambridge University Press.
  • Zinsser, W. (1976). On Writing Well. Harper & Row.
  • Lamott, A. (1994). Bird by Bird. Pantheon.
  • Didion, J. (1968). Slouching Towards Bethlehem. Farrar, Straus and Giroux.