SkillAgentSearch skills...

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.

Install / Use

npx skills add rampstackco/claude-skills --skill long-form-content-frameworks

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

86/100

Supported Platforms

Universal

Tags

Our assessment of long-form-content-frameworks

long-form-content-frameworks scores 86/100 on our quality scale, 741st of 1,153 Content & Media skills we index.

Its SKILL.md is 29 KB long, well organised into 17 sections and no code examples: a thorough specification that gives an agent plenty to work with.

It has 902 GitHub stars, a meaningful sign that others use it.

Substance
30/30
Structure
13/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so long-form-content-frameworks is actively maintained.
  • Our last check on 2026-11-03 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

long-form-content-frameworks compared with similar skills

All 4 of these similar skills score higher than long-form-content-frameworks; compare them before choosing.

SkillScoreStarsUpdatedFormat
long-form-content-frameworks (this skill)by rampstackco869022mo agoSKILL.md
siyuanby siyuan-note10047.3ktodayMCP Server
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.md

Frequently asked questions

How do I install long-form-content-frameworks?
Run npx skills add rampstackco/claude-skills --skill long-form-content-frameworks. The install tabs above show the steps for each supported agent.
Which AI agents does long-form-content-frameworks work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is long-form-content-frameworks safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is long-form-content-frameworks still maintained?
The repository was last updated about 2 months ago, so long-form-content-frameworks is actively maintained.

name: long-form-content-frameworks description: "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." category: content catalog_summary: "Structural patterns for individual long-form pieces (case studies, whitepapers, research reports, definitive guides, manifestos, ebooks, long-form tutorials) that distinguish publication-quality work from bloggy-long padding or academic bloat" display_order: 9

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.


What this skill is for

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).


Bloggy-long vs academic-bloat vs publication-quality

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.


Long-form formats and when each fits

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.


Structural archetypes

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.


Section weight calibration

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 simila

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars902
CategoryContent
Updated2mo ago
Forks124

Languages

JavaScript

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions