disciplinary-writing-scaffold

Installation
SKILL.md

Disciplinary Writing Scaffold

What This Skill Does

Produces a scaffold for a specific disciplinary writing genre — a lab report, a historical argument, a literary analysis, a mathematical explanation, a geographical case study — that reflects the actual conventions of that discipline rather than applying a generic "essay structure." Each discipline has its own way of constructing knowledge through writing: scientists write to report and explain phenomena through evidence; historians write to interpret and argue about significance; literary critics write to analyse authorial craft and effect. A science scaffold that looks like an English essay scaffold has failed. The output includes the structural scaffold, a discipline-specific language toolkit (vocabulary, sentence starters, hedging language, connectives), an annotated model, and differentiation options. AI is specifically valuable here because most teachers are experts in their discipline's content but not its writing conventions — they know what good disciplinary writing looks like but struggle to make its features explicit and teachable.

Evidence Foundation

Halliday (1993) and the systemic functional linguistics tradition established that language is not a neutral container for content — different disciplines use language differently because they construct knowledge differently. Science writing uses nominalisation (turning processes into things: "the water evaporated" becomes "evaporation"), passive voice, and hedging language because these features serve scientific purposes (objectivity, precision, tentativeness). Historical writing uses evaluative language, causal connectives, and qualification because historians construct arguments about significance. Martin & Rose (2008) mapped the genres used across school disciplines, showing that each subject requires students to write in multiple genres with distinct structural and linguistic features. Christie & Derewianka (2008) demonstrated that students' ability to write in disciplinary genres develops across schooling and requires explicit instruction — students do not naturally acquire the language features of scientific or historical writing just by reading examples. Graham & Perin (2007) found that explicit teaching of text structures is one of the most effective writing interventions (effect size 0.82). Shanahan & Shanahan (2008) argued that literacy instruction must become increasingly discipline-specific as students progress — generic reading and writing strategies are insufficient for advanced disciplinary learning.

Input Schema

The teacher must provide:

  • Writing task: What students must write. e.g. "Write a conclusion for the enzyme experiment" / "Explain why the Weimar Republic failed" / "Analyse how Shakespeare presents Lady Macbeth in Act 1, Scene 5" / "Explain why your answer to the problem is correct"
  • Discipline: The subject area. e.g. "Science (Biology)" / "History" / "English Literature" / "Mathematics"
  • Student level: Year group and writing competence. e.g. "Year 8, can write in paragraphs but their science writing reads like storytelling — 'we put the enzyme in and then it fizzed'"

Optional (injected by context engine if available):

  • Genre: The specific genre (if known)
Related skills
Installs
10
GitHub Stars
216
First Seen
Apr 2, 2026