15.05Academic University ResearchUndergraduateAvailable

Academic Writing Structure and Argumentation

Make your writing argue rather than describe: paragraph structure, engaging with literature, calibrated hedging, and editing for argument.

Free. Works on Claude, ChatGPT, Gemini or any assistant that accepts a skill file.

What this skill does

The method, encoded.

The largest single difference between a pass and a distinction is not effort, reading or fluency. It is whether the writing argues. Descriptive writing tells the reader what sources said, what was done and what was found. Analytical writing tells them what it means, why it matters, and why they should accept it. Most students can see the difference in someone else's work and cannot produce it in their own, because nobody has told them what the unit of production is.

The unit is the paragraph, and a paragraph that argues has four moves: a claim, the evidence for it, the warrant that makes the evidence count as support, and a link that makes the next claim necessary. The warrant is the move students omit, and its absence is the technical reason writing reads as descriptive.

From there the skill builds section-level argument where each part earns the next, converts a literature review organised by source into one organised by position, covers source integration and reporting verbs, hedging calibrated to evidence strength, how to disagree with a published author without straw-manning them, and the three classic chapter failures: the review that is a list, the methodology that describes without justifying, and the discussion that repeats the results.

It ends with an editing method that works on argument first and words second, which is the order students reliably reverse.

It diagnoses your text. It does not write it.

Best used for

  • Acting on feedback that says descriptive or lacking critical analysis
  • Converting a literature review that is a list into one that argues
  • Adding justification to a methodology chapter that only describes
  • Stopping a discussion chapter from repeating the results
  • Learning how to disagree with a published author appropriately
  • Calibrating hedging and academic register
  • Editing a complete draft for argument rather than wording

Typical inputs

What you give it.

The draft or the section being worked on, The controlling claim of the piece, or the acknowledgement that there is not one, Document type and its assessed criteria, Optional previous feedback on the student's writing, Optional sample of admired writing in the discipline, Word count and how much is already used

Typical outputs

What you get back.

Sentence-type diagnostic marking reporting, analysis and positioning, Reverse outline of first sentences with structural faults noted, Controlling claim register, one sentence per chapter, Paragraph audit for claim, evidence, warrant and link, Source integration review, including reporting verbs and citation prominence, Hedging calibration against evidence strength, Diagnosis of the classic chapter-level failures and their structural fixes, Prioritised edit plan, argument pass before sentence pass

Method coverage

What the skill works through.

  1. Why description scores lower than analysis
  2. Diagnosing your own writing: reporting, analysis, positioning
  3. The paragraph as a unit of argument: claim, evidence, warrant, link
  4. The missing warrant, and why writing reads as descriptive
  5. Reverse outlining a chapter in ten minutes
  6. Arguing with the literature instead of listing it
  7. Integrating sources so they support your point
  8. Choosing reporting verbs that do analytical work
  9. Disagreeing with a published author appropriately
  10. Hedging in proportion to your evidence
  11. Formality is precision, not obscurity
  12. The three classic chapter failures and their causes
  13. Editing for argument before editing for words

Download

Free skill. One file.

Enter your email once. Every skill you download after that takes a single click.

How to install

Add the skill file and the five kernel protocols to a Claude Project, a ChatGPT Project, a Gemini Gem, or paste them at the top of any assistant conversation. Then give it your real research material, not a description of it.

Download skill

Questions

Common questions.

What does "too descriptive" mean in feedback, and how do I fix it?

It means most of your sentences report what sources said, what you did or what you found, rather than saying what it means and why it matters. Mark two pages of your own draft as reporting, analysis or positioning and count them. The fix is structural: give each paragraph a claim in its first sentence, and add the warrant, the sentence or two explaining why your evidence supports that claim.

How should a paragraph be structured in academic writing?

Claim, evidence, warrant, link. State the paragraph's point first, in your own words. Give the evidence with citations. Explain why that evidence supports the claim, which is the step almost everyone omits. Then close with a sentence that makes the next paragraph necessary. Test it by deleting everything but the first and last sentences: if those two do not carry a claim and a consequence, the paragraph is a container rather than a step in an argument.

Why does my literature review read like a list?

Because it is organised by source. If each paragraph begins with an author's name, you have twenty-two summaries rather than a review. Reorganise by claim, theme or position, so each paragraph makes a point about the literature and cites several sources inside it. Put each source on a card with its claim, population, measure and design, and sort the cards; the sort that produces the most uneven groups is usually the one that reveals your argument.

How do I be more critical without just being negative?

Critical means assessing what the evidence supports, which often means agreeing with reasons. When you do disagree, represent the author's position at its strongest first, aim at a specific claim rather than the whole paper, and give a recognised ground: the design cannot support the inference, the sample does not extend to the population claimed, the construct is measured differently from how it is defined, or an alternative explanation is unaddressed. Criticising a limitation the author already acknowledged is weak.

How much should I hedge?

In proportion to your evidence, and once. A well-evidenced finding is stated plainly, because hedging a strong claim is miscommunication rather than modesty. A supported but contestable reading takes a single hedge plus its alternative explanation in the same passage. A speculation is labelled as one, with what would test it. Stacked hedges say nothing and signal defensive writing.

How do I make my methodology chapter more than a description?

Apply the test: would this chapter be equally true of a different project on a different question? If yes, it is a textbook account. After each methodological statement, add why it suited this particular question, and name at least one alternative you rejected and why. Justification requires a comparison; a decision with no alternative stated has not been justified.

My discussion just repeats my results. What should go in it?

Results state what was observed; the discussion states what it means. Each discussion paragraph works well as: the finding, how it relates to prior work, your interpretation, an alternative explanation, and the limit on it. A discussion paragraph with no citation and no interpretive move is a results paragraph in the wrong chapter.

What is a reverse outline?

Write out the first sentence of every paragraph, in order, and read only those. If they are topics rather than claims, the section is a container. If they could be reordered without loss, there is no argument. It takes ten minutes for a chapter and tells you more than reading the chapter through, because reading through is generous to your own intentions.

Should I edit for wording or for structure first?

Structure, always. Reverse outline, check each chapter has one controlling claim, delete paragraphs that report without arguing, and only then work on sentences. Students reliably do this in reverse and spend an editing week polishing paragraphs that should be cut. If you are over the word count, cut description rather than argument.

Research where people already are.
Analyse it where you already work.

Yazi helps researchers conduct surveys, AI interviews and longitudinal research directly through WhatsApp.

New Report on SA Gambling Impact
Check It Out