name: write-section description: Write or revise any thesis chapter section with section-specific templates, style matching, and verification
Write Section Skill
Write or revise a section of the thesis. This is a generalizable skill that adapts to any chapter based on section-specific templates and the established conventions from Chapters 3-5.
Arguments
introduction— Redirects to the/write-introductionskill (specialized)literature [section]— Write/revise a section of Ch.2 (e.g.,literature 2.1.4)abstract— Write the thesis abstract (~250 words)conclusion— Write Ch.6 (Conclusion)appendix Aorappendix B— Write appendix contentrevise <chapter>— Revise an existing chapter (e.g.,revise data,revise methodology)
If argument is introduction, invoke the /write-introduction skill instead.
Pre-Writing Protocol (ALL sections)
Before writing any section, you MUST:
- Read the target file to understand current state (stub? outline? partial draft? complete?)
- Read
thesis/CLAUDE.mdfor conventions, bib keys, custom commands - Read
CLAUDE.md(root) for project context, measure definitions, findings - Read
.claude/reference/literature-evidence.mdfor concrete findings from 20+ papers — use for any section that references literature - Read at least 40 lines from
03_data.tex,04_methodology.tex, and05_results.texto internalize the writing style - Read
references.bibto know which citations are available
Using the Narrative Architect
For literature-heavy sections (Ch.2 subsections, Ch.1 Antecedents, Ch.6 Interpretation), dispatch the narrative-architect agent BEFORE drafting. Provide:
- Goal: What the section needs to establish
- Target section: e.g., "§2.2 — Economic Shocks and Political Behavior"
- Constraints: Length, must-cite papers, emphasis points
The architect returns a paragraph-by-paragraph outline with specific paper citations and transition strategies. Use this as the backbone for your draft.
Style Requirements (from Chapters 3-5)
| Dimension | Convention |
|---|---|
| Person | First singular: "I define", "I estimate" |
| Tense | Present for methodology, past for data/literature |
| Sentences | 25-35 words average, clause-rich |
| Paragraphs | Topic sentence → support → transition |
| Asides | Em-dashes (---), not parentheses |
| Enumeration | Inline (i)/(ii)/(iii), NOT bullet points for arguments |
| Citations | \citet{} for subject, \citep{} for parenthetical |
| Cross-refs | \Cref{} start of sentence, \cref{} mid-sentence |
| Numbers | Exact figures inline, never rounded |
| Emphasis | \emph{} on first use, never \textbf{} in prose |
| Hedging | "consistent with", "suggesting", "indicating" |
| Forbidden | "interestingly", "it is worth noting", "we", rhetorical questions |
Section-Specific Templates
Abstract (~250 words)
Structure:
1. Context (1-2 sentences): The phenomenon and why it matters
2. Research question (1 sentence): Clear, precise
3. Method (2-3 sentences): Data, measure, estimation strategy
4. Findings (2-3 sentences): Main results with magnitudes
5. Contribution (1-2 sentences): What this adds to the literature
Rules:
- No citations in the abstract
- No forward references
- Must stand completely alone
- Use present tense throughout
- Every sentence must be informative (no filler)
Literature Review Section (Ch.2)
Structure per section:
1. Opening sentence: What this section covers and why
2. Core papers (3-5 per subsection): Narrative synthesis, NOT paper-by-paper summary
3. Comparative passages: "While X does A, Y does B, I instead do C"
4. Forward reference: Bridge to this thesis's approach
5. Closing transition to next section
Rules:
- Synthesize, don't summarize: Group papers by finding/methodology, not chronologically
- Position the thesis: Every subsection must contain at least one passage comparing prior work to this thesis
- Forward references: Use
\Cref{ch:methodology},\Cref{ch:data}, etc. - Discursive comparison (from style-paraphraser): "While \citet{frey2018robot} uses commuting zones, I exploit group-level variation..."
- No orphan citations: Every
\citekey must exist inreferences.bib - Use the evidence base: Consult
.claude/reference/literature-evidence.mdfor concrete findings and magnitudes. Use Section 7 flow templates as starting points for the narrative-architect agent.
New Section: §2.1.4 — The Global Decline of the Labor Share
This section needs to be ADDED to Ch.2. Template:
Content:
- Karabarbounis & Neiman (2014): Global labor share decline, investment goods prices
- Autor et al. (2020): Superstar firms and labor share
- Barkai (2020): Declining labor share and rising profit share
- Connection to task displacement: labor share decline as MEASUREMENT strategy
- Forward ref to \Cref{subsec:industry_td}: "I exploit this relationship..."
This section bridges the labor economics literature to the measurement strategy in Ch.4. It explains WHY declining labor share captures automation exposure.
Expanded Section: §2.2.3 — Shift-Share Identification
Expand the existing methodological parallels section:
Additional content:
- Borusyak, Hull & Jaravel (2022): Shift-share as IV, conditions for valid inference
- Goldsmith-Pinkham, Sorkin & Swift (2020): Shares-based vs shifts-based identification
- Connection to THIS thesis's design: predetermined shares from ACS, industry-level shifts from BEA-KLEMS
- Forward ref to \Cref{sec:empirical}
Shortened Section: §2.4 — Contribution
After /write-introduction migrates the detailed contribution to Ch.1:
New structure (1-2 paragraphs only):
- Brief enumeration of 4 contributions
- "As articulated in \Cref{ch:introduction}, this thesis contributes..."
- No detailed exposition (that's now in Ch.1)
Conclusion (Ch.6)
Structure:
1. Summary of findings (2-3 paragraphs)
- Restate RQ, method, main result
- Key magnitudes (β, lag structure)
- Heterogeneous effects
2. Interpretation (2-3 paragraphs)
- What the results mean for the backlash vs insecurity debate
- Why automation → conservative (mechanism)
- Connection to broader populism literature
3. Policy implications (1-2 paragraphs)
- Just transitions, retraining programs
- Political economy of automation policy
4. Limitations (1-2 paragraphs)
- Ecological inference caveat
- Pseudo-panel vs true panel
- Oster δ = 0.04 (sensitivity to unobservables)
- External validity (US only)
5. Future research (1 paragraph)
- Individual-level panel data
- European comparison
- Mechanism decomposition
- GenAI era extension
Rules:
- No new information: Everything must reference findings from Ch.5
- Honest about limitations: Don't oversell
- Forward-looking: End on future research, not caveats
- Length: ~4-6 pages, not longer
Appendix A (Additional Tables)
Content:
- Full regression tables with all coefficients
- Alternative specifications mentioned in Ch.5
- Summary statistics by demographic group
- Industry-level task displacement values
Rules:
- Every table must have a
\label{tab:app_...}and be referenced from the main text - Use
threeparttablewith notes - Match the formatting of Ch.5 tables exactly
Appendix B (Additional Figures)
Content:
- Diagnostic plots (residuals, leverage, etc.)
- Additional descriptive figures
- Sensitivity analysis plots
Rules:
- Every figure must have a
\label{fig:app_...}and be referenced from main text - Include substantive figure notes
- Check that files exist in
results/figures/before referencing
Post-Writing Protocol (ALL sections)
1. Compile
cd /Users/alessandro/Projects/Tesi/thesis && tectonic main.tex
2. Cross-Reference Check
Verify all \Cref and \cref targets exist. Tectonic will show Undefined reference warnings.
3. Citation Check
Verify all \citet and \citep keys exist in references.bib. Tectonic will show Undefined citation warnings.
4. Consistency Check
- Notation matches the notation registry (
.claude/rules/notation-registry.md) - Sign convention: higher TD = more automation exposure
- Group definition: 18 groups (Edu x Gender x Age)
- Panel sizes: national 486, state 23,814
5. Style Self-Review
Re-read the draft against the style checklist above. If the prose doesn't match Chapters 3-5, revise or dispatch to the style-paraphraser agent.
Multi-Pass Workflow
For any non-trivial section (>100 lines), follow this multi-pass approach:
Pass 1: RESEARCH
- Read relevant chapters, papers, analysis outputs
- Identify all citations needed
- List all cross-references needed
Pass 2: OUTLINE
- Write paragraph-level outline (1 sentence per paragraph)
- Verify logical flow
- Check that all required content is covered
Pass 3: DRAFT
- Write full prose following section template
- Insert all citations and cross-references
- Mark uncertain numbers with % TODO
Pass 4: STYLE
- Match voice/rhythm to Chapters 3-5
- Fix sentence length, transitions, paragraph structure
- Remove filler and passive voice
Pass 5: VERIFY
- Compile with tectonic
- Check all references and citations
- Content verification against source material
For short sections (<100 lines), passes 2-3 can be combined.