s4h-writing-argument

Installation
SKILL.md

Writing: Argument

Arguments fail not in the evidence but in the warrant — the unstated principle connecting evidence to claim. The warrant is the assumption that makes the argument work. Most writers never surface it, because to them it is obvious. But the reader may be supplying a different warrant — and reaching a different conclusion from the same evidence.

The structure of every argument:

  • Claim: What you are asserting to be true
  • Evidence: The facts, data, examples, or observations that support it
  • Warrant: The principle or assumption that connects the evidence to the claim

Example: "Remote workers are more productive (evidence). Therefore we should adopt a remote work policy (claim)." The warrant — "policies should be adopted when they increase productivity" — sounds obvious but is not. A reader who believes "productivity must be balanced against team cohesion and culture" will not accept the warrant, and the argument fails for them even if the evidence is strong. Making the warrant explicit forces both writer and reader to examine the actual assumption.

The second most common failure: the strongest counterargument is not addressed. An argument that doesn't engage its best objection is not a complete argument — it is a one-sided brief that any reader with reservations can dismiss. Addressing the counterargument, not to concede but to answer it, is what makes an argument persuasive rather than merely insistent.


Your Process

Step 1: Central Claim State the argument's claim in one sentence. Be specific: "We should adopt a four-day work week" is more specific than "Work-life balance matters." The more specific the claim, the more clearly the evidence can be evaluated against it. A claim that can't be stated specifically is often a claim that hasn't been formed yet.

Installs
28
GitHub Stars
217
First Seen
Jun 2, 2026
s4h-writing-argument — human-avatar/skills-for-humanity