OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add rampstackco/claude-skills --skill long-form-content-frameworks
Patterns for individual long-form content pieces. Case studies, whitepapers, research reports, definitive guides, manifestos, ebooks, long-form tutorials. The structural disciplines that distinguish publication-quality long-form from bloggy-long padding or academic bloat. Different from pillar-content-architecture (which covers hub structure); this skill covers individual deep-dive pieces. Triggers on long-form content, case study writing, whitepaper, research report, definitive guide, ebook, manifesto, long-form tutorial, deep-dive article, anchor piece, foundational article, structural archetypes. Also triggers when a piece is over 3,000 words and the team is unsure how to structure it, when a long-form draft feels padded or saggy, or when a flagship asset needs the depth to actually earn the length.
npx skills add rampstackco/claude-skills --skill long-form-content-frameworks
A senior editorial leader's playbook for individual long-form content pieces. The structural disciplines that distinguish publication-quality work from bloggy-long padding or academic bloat.
Long-form is where most content programs lose their nerve or lose their way. Teams either stretch a 1,500-word post to 5,000 with filler (the bloggy-long failure mode), or they over-document the topic with no editorial spine (the academic-bloat failure mode). The pieces that earn their length are the ones where each section justifies its weight, the lede sets a thesis the body actually delivers, and the closing leaves the reader with something specific.
This skill covers the individual long-form piece: the case study, the whitepaper, the research report, the manifesto, the ebook chapter or full ebook, the definitive guide, the long-form tutorial. Different from pillar-content-architecture (which covers HUB architecture: how a pillar plus cluster system fits together), this skill covers the long-form PIECE itself, regardless of whether it sits at the center of a hub or stands alone.
The voice is the senior editorial leader who has shipped dozens of flagship long-form assets and watched plenty of others fail. Honest about which formats earn their length, which structural archetypes fit which problems, and where long-form most often goes wrong.
When to use this skill: planning a flagship long-form piece, structuring a draft that feels saggy, reviewing a long-form piece that is technically correct but emotionally flat, or auditing a content library to find the long-form pieces that should have been blog posts.
This skill spans individual long-form content pieces. The content suite distinction:
content-strategy is program scope: what to produce across the program.pillar-content-architecture is HUB scope: pillar plus cluster as a topical hub system.long-form-content-frameworks (this skill) is PIECE scope for long-form: individual deep-dive pieces, standalone or as pillars.content-and-copy is execution scope at any length: writing the words.content-brief-authoring is per-piece brief scope at any length: the contract.editorial-qa is gate scope: pre-publish verification.ai-content-collaboration is workflow scope: how humans and AI compose.A pillar page IS often a long-form piece. The two skills compose: pillar-content-architecture decides the hub shape and which pieces sit where; this skill is how you structure the long-form pieces themselves so they earn the length they take up.
The audience: editorial leads, content directors, in-house teams shipping flagship long-form, agencies producing whitepapers and research reports, anyone planning a piece that will run 3,000+ words and need to hold a reader to the end.
What is not in scope: blog-post-length writing (covered by content-and-copy), the brief itself (covered by content-brief-authoring), the hub architecture around a long-form piece (covered by pillar-content-architecture), or the pre-publish QA pass (covered by editorial-qa).
The keystone framing. Two failure modes plus the discipline.
Bloggy-long. A regular blog post stretched to 5,000 words via padding. Same structural shape as 1,500 words, just inflated: more transitional paragraphs, more "before we get into it," more recap sections, more bullet expansions of single ideas. The reader notices within 600 words and skims. Output: a piece that ranked because it was long, never gets read all the way through, never gets shared, never earns links because nobody finished it.
Academic-bloat. Exhaustive coverage that loses the thread. 8,000 words where 4,500 would have served. Every adjacent topic surveyed; every definition restated; every caveat documented. Reader respects the effort and skims for the parts they need. Output: a "comprehensive" piece that nobody reads end-to-end, that does not change anyone's mind, that performs in search but underperforms in trust.
Publication-quality. Structural depth that earns the length. Each section justifies its weight. The lede establishes a thesis the body delivers. The closing is specific. Reading flow varies in density, register, and rhythm so the piece sustains attention. The piece reads as the work of someone who had something specific to say and the discipline to say it well at length.
The litmus test. Ask of any long-form draft: would cutting this section weaken the argument, or would it just make the piece shorter? If cutting strengthens it, the section was filler. The piece earns its length when each section is doing structural work the argument requires.
Seven formats, each with a different structural shape and a different reader contract.
Case study. A specific company, project, or initiative with quantified outcomes. Reader contract: "Show me what worked and why, with specifics." Length: 2,000 to 4,000 words typical. Structural archetype: usually problem-solution. The case-study tax: real numbers, real names, real specificity. Generic case studies signal nothing.
Whitepaper. A position document on a substantive topic, typically with original analysis. Reader contract: "Take me through your reasoning on this question with the rigor I would expect from a serious source." Length: 3,000 to 8,000 words. Structural archetype: layered argument or comparative analysis. Often gated. The whitepaper tax: original synthesis, not survey of existing literature.
Research report. Original primary research presented with methodology, findings, implications. Reader contract: "Show me the data, how you collected it, what it means." Length: 4,000 to 12,000 words. Structural archetype: taxonomic survey or comparative analysis. The research-report tax: actual primary research, not "we surveyed 300 marketers" with leading questions.
Definitive guide. Comprehensive coverage of a topic for a specified audience. Reader contract: "Be the canonical resource on this." Length: 4,000 to 10,000 words. Structural archetype: taxonomic survey. The definitive-guide tax: actual comprehensiveness; gaps reveal that the guide is not actually definitive.
Manifesto. A position paper on what the writer believes and why, often confrontational. Reader contract: "Tell me what you think and convince me." Length: 1,500 to 6,000 words. Structural archetype: layered argument or narrative arc. The manifesto tax: actual conviction, not diplomatic hedging.
Ebook. Multi-chapter long-form, often a sequence of related pieces with introduction and conclusion. Reader contract: "Take me through a body of work." Length: 8,000 to 30,000+ words. Structural archetype: usually narrative arc across chapters. The ebook tax: each chapter earns its place; the table of contents is not padding.
Long-form tutorial. Instructional content where the reader is following along. Reader contract: "Take me from where I am to where I want to be, step by step." Length: 3,000 to 8,000 words. Structural archetype: problem-solution with sequential steps. The long-form-tutorial tax: every step actually works; gaps in the sequence break the reader.
Detail in references/format-decision-framework.md.
Five archetypes that fit different long-form problems.
Problem-solution. State the problem with weight; develop why it matters; present the solution; show how it works; address objections. Fits case studies, long-form tutorials, manifestos with a clear opposition. Risk: feels formulaic if every piece uses it.
Narrative arc. Beginning, middle, end. A protagonist (often the company, sometimes a person, sometimes the reader) faces a complication and resolves it. Fits ebooks, some case studies, longer manifestos. Risk: forced narrative on topics that are not actually stories.
Layered argument. Position stated; layer 1 evidence; layer 2 evidence; counter-arguments addressed; synthesis. Fits whitepapers, manifestos, position pieces. Risk: feels academic if the layers do not build to a real synthesis.
Taxonomic survey. A topic mapped into categories; each category explored; relationships among categories surfaced. Fits definitive guides, research reports surveying a landscape. Risk: feels like a list with subheads if the taxonomy is not actually load-bearing.
Comparative analysis. Multiple options, frameworks, or positions compared along defined axes; tradeoffs surfaced; the writer's recommendation argued. Fits whitepapers, decision-guide research reports, technology comparisons. Risk: feels like a feature matrix if the analysis is shallow.
Most strong long-form pieces use one archetype as the spine and borrow from another for variation. A whitepaper might be a layered argument with comparative-analysis sections. A definitive guide might be a taxonomic survey with problem-solution chapters. The archetype is the spine; variation prevents the piece feeling formulaic.
Detail in references/structural-archetype-patterns.md.
How long sections should be relative to each other, varying by format.
The general principle: section weights match how much load the section is bearing in the argument. Throat-clearing introductions get cut. Setup sections are short. Argument-bearing middle sections are longest. Closings are specific and tight.
Whitepaper / research report typical weights. Introduction 8-12% (thesis stated, scope set). Methodology or framing 10-15% (how the analysis works). Body 60-70% (the actual argument or findings, divided into 3-5 weighted sections). Implications 10-15%. Closing 3-5%.
Case study typical weights. Setup and context 15-20% (the company, the problem, why it mattered). Solution narrative 50-60% (what was done, in sequence). Outcomes 15-20% (quantified results, what worked, what did not). Reflection 5-10% (what the team would change).
Manifesto typical weights. Position 5-10% (what is believed, stated early and clearly). Argument 70-80% (why, with the layers building intensity). Call 10-15% (what should change as a result).
Definitive guide typical weights. Introduction 5-8% (what the guide covers, who it serves). Body across taxonomic sections 80-85% (each section roughly even). Closing and additional resources 7-10%.
Long-form tutorial typical weights. Setup 10-15% (what the reader will achieve, what they need). Sequential steps 70-80% (each step its own subsection). Troubleshooting and edge cases 10-15%.
The audit. If one section is more than 3x the length of another bearing similar argumentative load, the piece is structurally unbalanced. Either the long section needs to be split, or the short section needs to be deepened, or the imbalance reflects an actual content problem the writer has not surfaced.
Detail in references/section-weight-calibration.md.
Long-form ledes do different work than blog-post ledes.
A blog-post lede answers the user's likely query in the first 200 words. A long-form lede establishes a thesis the next 5,000 words will deliver, sets the reader's expectations for the piece's depth, and earns the reader's attention for the time investment ahead.
Patterns that work.
Patterns that fail.
The first paragraph of a long-form piece is the writer's only sales pitch for the next 30+ minutes of the reader's attention. Spending it on filler is the most common long-form failure.
Detail in references/lede-patterns-for-long-form.md.
Long pieces that hold readers vary their density, register, and rhythm. Pieces that lose readers feel uniform: same paragraph length, same sentence rhythm, same density of claim, page after page.
Density variation. Some sections argue tightly (claim, evidence, claim, evidence). Others reflect, illustrate, or breathe. The argument-tight sections earn the breathing sections; the breathing sections give readers room to absorb.
Register variation. Most long-form pieces sustain a primary register (analytical, narrative, instructional) while occasionally shifting to a secondary register (anecdotal, reflective, declarative) for variation. A whitepaper that is purely analytical for 6,000 words exhausts the reader; a whitepaper with a mid-piece anecdote or a closing reflection lands harder.
Rhythm variation. Sentence length variation matters more in long-form than short. Strings of 25-word sentences blur; strings of 8-word sentences fragment. The pattern that holds attention: medium sentences with occasional short punches and occasional layered longer constructions.
Visual rhythm. Subheads, pull quotes, callouts, charts, illustrations break the page into navigable units. Long-form pieces with no visual rhythm are walls of text; long-form pieces with too many breakouts feel like marketing collateral. The rhythm: visual element every 600-1,000 words on average, varied in type.
Mid-piece micro-thesis. Around the 40-60% mark, restate the central claim with new framing. Long-form readers' attention naturally dips mid-piece; the mid-piece restatement reorients them and refreshes engagement.
Detail in references/attention-sustaining-techniques.md.
Long-form pieces cite more, and cite more authoritatively, than blog posts. The reader is investing 30+ minutes; the writer owes them claims they can verify.
Source hierarchy for long-form.
Citation density. Long-form arguments need citations roughly proportional to claim density. A piece making 30 falsifiable claims needs 30 citations; a piece making 5 strong claims with extensive elaboration may need 5. The audit: every falsifiable claim is either cited or attributed to the writer's own analysis.
Source freshness. Statistics older than 3 years for fast-moving topics need refresh or explicit acknowledgment. The "85% of marketers" stat from 2018 in a 2026 piece signals stale research.
Inline vs endnote citations. Long-form on the web typically uses inline links to authoritative sources. For research-heavy pieces, endnote-style citations (numbered footnotes) signal academic rigor; for editorial whitepapers, inline links keep momentum. Either works; pick one and stay consistent within the piece.
Detail in references/citation-and-source-authority.md.
Long-form earns visual breakouts; blog posts often do not. The discipline is which breakouts earn their place.
Visual element types.
Earned-position rule. Each visual element earns its place by carrying argumentative load the prose alone cannot. Decorative charts that restate the prose visually weaken the piece; charts that surface a pattern the prose can only summarize strengthen it.
Production tax. Each visual element costs design time, accessibility work (alt text, screen-reader-friendly tables), and revision overhead when the underlying content changes. Long-form pieces with 25 charts each take meaningful production time to maintain. Plan visual count against production capacity, not against ideal-world maximalism.
Anti-pattern: the stock-image header. Generic stock imagery at the top of a long-form piece signals the writer did not commission visual work for the piece. Either commission specific visual work (custom illustrations, branded data visualizations, scene photography) or skip the hero image.
Detail in references/breakouts-and-visualization.md.
Long-form pieces with strong closings get shared, get linked, and get remembered. Pieces with throat-clearing closings disappear after the last subhead.
Closings that work.
Closings that fail.
The audit. Ask of any long-form closing: does this leave the reader with something specific to do, decide, or think about, or does it just signal the piece is ending? If the latter, rewrite.
Detail in references/closing-patterns.md.
Long-form's distribution shape differs from blog-post distribution. The format choices echo through how the piece reaches readers.
Gated vs ungated. Whitepapers and research reports often gate behind a form to capture leads; ebooks frequently do; case studies sometimes do. The tradeoff: gating cuts reach by 70-90%; the gated audience is qualified but small. Manifestos and definitive guides typically stay ungated to maximize reach and link equity. The decision turns on whether the piece's primary value is reach (ungated) or qualified-lead capture (gated).
Format choices. Long-form web page (HTML), downloadable PDF, mixed (web with PDF download option), interactive (web with embedded tools or visualizations). Web pages earn search traffic; PDFs earn email-shareable assets; mixed maximizes both. The production cost rises with format count.
Syndication and excerpting. Long-form pieces lend themselves to chapter excerpts, summary blog posts, and email-newsletter serializations. Plan the excerpting at piece-design time so the chapters or sections are excerpt-ready. See content-repurposing for the cross-format adaptation discipline.
Refresh schedule. Long-form pieces with research components need annual or quarterly refresh on the data; long-form pieces with timeless framings need lighter touch. See content-refresh-system for refresh prioritization.
The decision sequence: format first, distribution shape second. A research report's distribution shape (often gated, often PDF, often paired with a webinar) follows from the format choice; trying to retrofit distribution onto a piece that was written for the wrong shape produces friction.
Rapid-fire. Diagnoses in references/common-long-form-failures.md.
When planning or auditing a long-form piece, walk these 12 considerations.
The output of the framework is a long-form piece that earns its length: every section justified, every page sustaining attention, every claim verifiable, every closing specific.
This skill's output depends on data, measurements, or tool results it cannot generate on its own. When a required input, tool, or data source is unavailable or unverifiable, the sanctioned output is the deliverable with the gap stated: what was needed, what was actually obtained or verified, and which parts of the output are affected. Fabricating, estimating, or interpolating a required number to complete the deliverable is never sanctioned. A stated gap is a complete answer.
references/format-decision-framework.md - When each long-form format fits. Reader contracts, length norms, structural archetype tendencies, format-specific taxes.references/structural-archetype-patterns.md - Five archetypes (problem-solution, narrative arc, layered argument, taxonomic survey, comparative analysis) with worked examples and combination patterns.references/section-weight-calibration.md - Typical weight ratios by format. Whitepaper, case study, manifesto, definitive guide, long-form tutorial profiles. The 3x audit.references/lede-patterns-for-long-form.md - Five patterns that work, four that fail. The first-paragraph sales-pitch frame.references/attention-sustaining-techniques.md - Density variation, register variation, rhythm variation, visual rhythm, mid-piece micro-thesis discipline.references/citation-and-source-authority.md - Source hierarchy, citation density, freshness, inline vs endnote conventions, citation-laundering anti-pattern.references/breakouts-and-visualization.md - Visual element types, earned-position rule, production-tax discipline, the stock-image-header anti-pattern.references/closing-patterns.md - Five closings that work, four that fail. The specific-call, reframed-thesis, open-question, personal-reflection, provocation patterns.references/common-long-form-failures.md - 11+ failure patterns with diagnoses, including bloggy-long, academic-bloat, throat-clearing leads, visual-count overruns, citation laundering, format-tax failures.Length is not a virtue. A 5,000-word piece is only worth more than a 1,500-word piece if those extra 3,500 words carry structural and argumentative load the shorter version could not. Most long-form content underperforms because the team chose length first and structural depth second.
The discipline is the inversion. Decide what the piece needs to deliver, choose the format and archetype that fit, calibrate sections to actual argumentative load, and let the length follow. Pieces written that way earn their length and read as the work of someone who had something to say. Pieces written length-first read as filler, no matter how many subheads dress them up.
When in doubt about whether a long-form piece is ready, ask: does each section justify its weight, does the lede earn the next 30 minutes, does the closing leave the reader with something specific, are claims cited, do visuals carry load, does the mid-piece micro-thesis refresh attention? If yes to all of those, the piece is publication-quality. If no to any, the gap is where the reader stops reading.