white-paper-writing
Use when writing white papers, technical reports, policy documents, thought leadership pieces, or any long-form authoritative document. Triggers on requests to write, structure, outline, or review white papers, technical reports, position papers, policy briefs, or evidence-driven arguments. Also use for B2B content marketing strategy, technical documentation requiring authority, academic-style reports, or any document that must educate while persuading. Use when someone asks "how should I structure this" for a long-form document.
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 5
- Forks
- 3
01 前言 Front Matter
- name
- white-paper-writing
- description
- Use when writing white papers, technical reports, policy documents, thought leadership pieces, or any long-form authoritative document. Triggers on requests to write, structure, outline, or review white papers, technical reports, position papers, policy briefs, or evidence-driven arguments. Also use for B2B content marketing strategy, technical documentation requiring authority, academic-style reports, or any document that must educate while persuading. Use when someone asks "how should I structure this" for a long-form document.
03 SKILL.md 正文
White Paper Writing: The Complete Guide
What a white paper actually is
A white paper is an authoritative, evidence-driven document that educates readers about a complex issue while advancing a specific position or solution. The critical tension: informational in form, persuasive in function.
The term traces to British government practice. The Churchill White Paper of 1922 on Palestine is the earliest widely cited example — British government reports with blue covers ("Blue Books") were comprehensive; shorter reports received plain white covers. Subsequent landmark white papers shaped geopolitics. By the 1990s the term migrated into technology and business.
Today the term encompasses four meaningfully different document types:
| Type | Purpose | Audience | Key difference |
|---|---|---|---|
| Government | Policy proposals for future legislation | Parliamentarians, civil servants, public | Follows a Green Paper consultation; proposes legislation |
| Academic (working paper) | Circulates preliminary findings without formal peer review | Researchers, funding agencies, fellow scholars | No external validation; credibility depends on institution + evidence quality |
| Corporate | B2B lead generation and trust building | Technical evaluators, C-suite, purchasing teams | Educates potential buyers while positioning the sponsoring organization |
| Technical | Specifications and architecture documentation | Engineers and implementers | More reference document than persuasive document |
Recognizing which tradition you are writing in determines everything — citation density, length, structure, tone, and whether you include a call to action.
How white papers differ from neighboring genres
White papers occupy a unique rhetorical niche. Knowing what they are not helps:
| Document type | How it differs from a white paper |
|---|---|
| Case study | Narrow focus on one customer's experience — "looking down through a magnifying glass at one flower" vs. white paper's "looking up through a telescope at a whole galaxy" |
| Research paper | Communicates original findings with full methodological transparency; a white paper can selectively marshal evidence for a position |
| Technical report | Comprehensive data and analysis without necessarily advocating a solution |
| Position paper | Openly advocates; a white paper persuades through the appearance of objectivity |
| Blog post | 300-2,000 words, informal; a white paper develops an idea rigorously across 2,500-7,000 words with cited evidence |
The three rhetorical foundations
The Purdue OWL captures the central discipline: "If you advertise before convincing your readers of the truths of your argument, they are more likely to be turned off."
Ethos (credibility): established through depth of research, institutional credibility, professional presentation, and citation of reputable third-party sources. Every claim needs a named, verifiable source. Citing Gartner, Forrester, academic journals, or government statistics builds credibility far more than citing your own materials.
Logos (logical argument): the problem framing, evidence marshaling, and logical solution development. The argument structure must be airtight. Problem → cause analysis → solution that addresses the cause.
Pathos (connecting to reader pain): enters through the problem statement, which connects to the reader's specific pain points and creates urgency. Without pathos, readers do not feel the problem is their problem.
The 80/20 rule: 80% of content should be genuinely educational and valuable; only 20% should reference your organization or offering. Invert this ratio and you have produced a brochure, not a white paper.
Audience types and how to adapt
C-suite readers want: ROI implications, risk exposure, strategic fit, competitive implications. Give them: quantified business impact, regulatory risk, benchmark comparisons. They will read the executive summary and the conclusion; the body should stand alone for their direct reports.
Technical evaluators want: architecture details, integration complexity, security posture, operational requirements. Give them: diagrams, specifications, comparison tables, technical proof points, references to standards.
Policy analysts want: regulatory feasibility, precedent, stakeholder impact, implementation challenges. Give them: regulatory citations, cross-jurisdiction comparisons, case studies from comparable implementations.
Practical rule: if you do not know who will read this, write for the technical evaluator — they are the most demanding audience and their approval is usually required before a purchase decision reaches the executive.
Classic structure for the corporate white paper (problem/solution format)
This is Gordon Graham's "chocolate" format — the richest and most impactful. Use for: top-of-funnel thought leadership, executive influence, lead generation.
Cover page
Benefit-oriented title. Five proven title formats:
- How-to: "How to [achieve outcome] Without [common obstacle]"
- Numbered: "Five Ways [specific audience] Can [achieve outcome]"
- Question: "Why [common approach] Fails [specific audience] — and What to Do Instead"
- Provocative: "[Surprising claim that reframes the problem]"
- New approach: "The [New Approach] to [Established Problem]"
Nothing undermines a white paper faster than an amateurish cover. Subtitle, company logo, author name and title, date, professional design.
Executive summary (250-350 words, ~7% of total)
State: the problem, why it matters now, the proposed approach, key findings, who this is for. Must stand alone — many decision-makers read only this section. Write it last, after the rest of the paper is complete.
Introduction / hook (450-700 words, ~13%)
Open with a compelling statistic, scenario, or provocative question. Establish relevance to the reader's world. State the paper's purpose and preview the structure. Do not sell. Do not start with company history.
Bad opening: "This white paper introduces ABC company's new freight service." Good opening: "This white paper discusses how to choose a freight service that best fits your needs."
Problem definition (600-900 words, ~18%)
Three required elements per the George Mason University Writing Center:
- Core problem: the situation that needs to change
- Cause: what creates it (critical — how you characterize the cause determines which solutions appear logical)
- Impact: the harmful consequences, quantified with specific data
Replace vague assertions with specific evidence: not "employee engagement is low" but "across a 2024 survey of 500 enterprise IT teams, 67% reported [specific metric], costing an estimated $X per year in [specific consequence]."
Do not mention your product. Do not pose problems you cannot solve. Do not exaggerate — the reader will discount everything else if the problem feels inflated.
Background / context (400-700 words, ~12%)
Provide industry context, historical perspective, and an honest assessment of why prior approaches fell short. Demonstrate authoritative knowledge while keeping the narrative moving forward.
Solution overview (900-1,400 words, ~25% — the centerpiece)
Present your approach, framework, or methodology. Explain how it addresses the root causes identified in the problem section. Differentiate from prior approaches. Use case studies or analogies to illustrate.
Critical rule: do not name your specific product until the final paragraphs, if at all. The reader should feel the solution is the logical, inevitable conclusion of the preceding analysis. If the solution section reads as a product pitch, the entire edifice collapses — the reader realizes they were manipulated, not educated.
Benefits and evidence (500-900 words, ~13%)
Quantify ROI, efficiency gains, or risk reduction. Include case studies, third-party research validation, and expert citations. Use specific, verifiable data from named sources. Before-and-after comparisons are powerful. Avoid unsubstantiated claims and cherry-picked statistics.
Implementation considerations (300-600 words, ~9%)
A realistic roadmap: steps, prerequisites, potential challenges, timeline, success indicators. Build confidence that the solution is achievable. Do not make everything sound effortless — readers distrust claims that understate complexity.
Conclusion and call to action (200-350 words, ~5%)
Summarize the key argument. Restate urgency. Include a clear but subtle next step — schedule a consultation, download a tool, contact the team. Do not introduce new arguments. Do not pivot into a hard sell.
About the company (150-250 words)
Brief overview of relevant expertise, credentials, notable clients, and contact information. Think credibility stamp, not brochure.
References
Cite all sources consistently. Hyperlink URLs for digital distribution.
Academic white paper structure (working paper / technical report)
Approximately 8,000 words / 20 pages. Each section with recommended proportions:
| Section | Length (words) | % of total |
|---|---|---|
| Title page + abstract | 150-300 | 2% |
| Table of contents | auto-generated | — |
| Introduction | 800-1,200 | ~12% |
| Literature review | 1,200-1,600 | ~18% |
| Methodology | 800-1,200 | ~12% |
| Analysis and discussion | 2,400-3,200 | ~35% |
| Conclusions | 400-640 | ~6% |
| Recommendations | 240-400 | ~4% |
| References + appendices | as needed | — |
The abstract (academic) vs. executive summary (corporate): abstracts are 150-300 words, self-contained, oriented toward scholarly readers; executive summaries are longer (1-2 pages), may include graphics, and target decision-makers who need actionable recommendations without reading the full document.
Literature review discipline: organize thematically, not chronologically. Synthesize across sources to identify patterns, contradictions, and gaps. Conclude by showing how the literature identifies the gap your work fills. Avoid the annotated-bibliography-in-disguise format.
Evidence standards and citation
Credibility hierarchy (highest to lowest):
- Primary research you conducted
- Peer-reviewed academic research
- Government and NGO data (NIST, Gartner, Forrester, IDC with sponsor disclosure)
- Industry analyst data (know that analysts are often funded by vendors being analyzed)
- Vendor-sponsored studies (must disclose; readers heavily discount)
Statistics need context: "40% improvement" means nothing without a baseline, a sample size, a methodology, and a time frame. Always include: who collected the data, when, from how many respondents/systems, using what methodology.
The 42% rule: a 2021 survey found 42% of B2B buyers rated white papers as the most valuable content when researching a purchase, with 57% preferring them early in the buying process. The white paper is the most trusted format in the B2B buying journey — which is exactly why debasing the format with premature selling is so damaging.
Narrative arc: the story beneath the structure
The most memorable white papers have an underlying narrative arc:
Ordinary world: the reader's current reality, the status quo. Establish this in concrete, specific terms — not abstract industry platitudes but the actual experience your reader is having.
Complication: why the ordinary world is failing. The problem is getting worse, or the stakes just increased, or a new development makes the old approach obsolete. This is where urgency is established.
Resolution: your approach, framework, or insight. This arrives only after the reader has fully understood the complication — the resolution is earned, not advertised.
Transformed world: what the reader's world looks like after applying the approach. Specific, measurable, believable.
This arc maps to the classical white paper structure: Problem Definition = Ordinary World + Complication; Solution Overview = Resolution; Benefits = Transformed World.
The most common mistakes
The sales pitch in disguise (48.1% of white papers reviewed in one survey were blatant product promotions): if the reader reaches the end feeling sold to rather than educated, the white paper has failed. The test: could you remove all company branding and still have a valuable document?
Vagueness without data: every major claim needs a specific, sourced statistic or case study.
Excessive length: the trend is toward shorter documents. A well-reasoned 6-page white paper beats a padded 15-page one.
Jargon overload: define technical terms. Do not assume the reader has your acronym vocabulary.
Weak conclusions that restate the introduction: conclusions should synthesize — draw together the threads into a landing that is more than the sum of the parts.
Poor alignment between problem and solution: if the solution does not directly address the cause as characterized in the problem section, the argument collapses. Work backward: define the solution first, then characterize the cause in a way that makes your solution the logical response.
Formatting and length specifications
Length: 2,500-7,000 words; 8-15 pages typical B2B corporate; government = variable; academic = 8,000-15,000 words.
Typography:
- Body: 11-12pt (Calibri, Garamond, or Georgia for digital; Times New Roman for print)
- H1: 18-24pt
- H2: 14-18pt
- Captions: 8-10pt
- Line spacing: 1.2-1.5× for published versions; double-space for review drafts
- Optimal line length: 65-75 characters (45-90 maximum for readability)
Data visualization: 65% of information is retained with visuals, compared to 10-20% with text alone. Use bar charts for comparisons, line graphs for trends, donut charts (preferred over pie) for part-to-whole. Apply brand colors consistently. Always label directly rather than using legends where possible.
Accessibility: 4.5:1 minimum contrast ratio (WCAG 2.1 Level AA). Alt text for all meaningful images. Tagged PDFs for screen reader navigation.
Toolchain recommendations
Academic/technical: LaTeX (Overleaf for collaboration) — precise typesetting, automated cross-referencing, BibLaTeX for citations. Essential packages: geometry, hyperref, biblatex, booktabs, cleveref.
Corporate: Word + Styles system for consistent formatting and auto-generated TOC. Export to PDF. For highly designed versions, Adobe InDesign or Affinity Publisher.
Version-controlled technical writing: Markdown + Pandoc + Git. Write in Markdown (one sentence per line for clean diffs), use YAML front matter for metadata, compile to PDF/DOCX via Pandoc with --citeproc for citations.
Citation management: Zotero (free, open-source, best browser capture) for most users; BibLaTeX/Biber for LaTeX workflows; EndNote for large-scale systematic reviews with institutional licenses.
04 同仓库更多 Skills
prose-technical-mechanics
Use when editing or writing prose at a technical/mechanical level: choosing between Anglo-Saxon and Latinate diction, placing information in topic vs stress positions, writing periodic vs cumulative sentences, handling sentence rhythm, punctuation as logic, transitions, paragraph structure, or phonesthetics. Use when someone wants to understand WHY prose works or doesn't, not just surface-level style advice. Triggers on word choice, sentence structure, emphasis, rhythm, diction, or any deep writing mechanics question.
prose-mechanics
Use when writing, editing, or analyzing prose style; when trying to avoid generic AI-sounding writing; when applying specific prose styles such as journalistic, academic, narrative, KJV biblical, Hemingway plain, Latinate/Jamesian, Orwellian, Augustan, Victorian, Early Modern (Bacon, Browne, Milton), or free indirect discourse; or when coaching someone on writing voice and mechanics. Triggers on any request to improve, analyze, or write in a specific prose style, to fix "AI-sounding" writing, to make prose more vivid or concrete, to vary sentence rhythm, or to understand how a particular writer achieves their effects.
narrative-structure
Use when structuring stories, pitches, presentations, white papers, or any persuasive narrative; analyzing the hero's journey in fiction or non-fiction; applying StoryBrand for business communication; designing narrative arcs for thought leadership; or understanding Vogler, Snyder, Propp, or Campbell frameworks. Triggers on any narrative structure, storytelling, pitch structure, StoryBrand, hero's journey, three-act structure, Freytag, Save the Cat, narrative arc, or "how should I structure this story/pitch/presentation" request.
legal-brief-writing
Use when writing legal briefs, motions, or any court filing; when analyzing judicial cognition and persuasion; when applying elite brief-writing techniques from Roberts, Clement, Kagan, Garner; or when structuring legal arguments for maximum persuasion. Also use for autistic/neurodivergent advocates who need to understand how their natural communication style maps to elite legal advocacy. Triggers on any legal writing, brief drafting, motion preparation, or legal argument structuring request.
journal-publishability-criteria
Use whenever a research paper, article or preprint is being written, revised, reviewed or published, and specifically before every publication of docs/paper.md. Covers what legitimate journals actually gate on, in order of gating — the editor's desk screen (scope, novelty, package problems), what reviewers judge (methodological soundness, claims the evidence can carry, statistical and qualitative reporting), EQUATOR reporting guidelines, the ICMJE authorship criteria, COPE's view of text recycling, the near-universal generative-AI policy (no AI author, disclosure, author responsibility), TOP 2025 transparency standards, how to verify a journal is legitimate, submitting without an institution, and a pre-submission checklist. Triggers on requests to evaluate, review, prepare or submit a paper, to judge publishability, to write a declarations or data-availability section, to disclose AI use, or to check a journal.
shop-woodworking-tools-sharpening-joinery-and-finishing
Use for woodworking operations: layout and marking, hand tools and how to use them well, sharpening and why it is the skill everything else depends on, the shop machines, the table saw specifically including kickback and the guarding that prevents it, joinery technique, glue-ups and clamping strategy, and wood finishing from surface preparation through film and penetrating finishes.