Skip to main content
ClaudeWave
Skill333 repo starsupdated today

long-form-content-frameworks

This skill provides structural patterns for individual long-form content pieces, including case studies, whitepapers, research reports, definitive guides, and ebooks. Use it when planning flagship long-form assets, restructuring drafts that feel padded or directionless, or distinguishing publication-quality work from filler-bloated pieces that don't earn their length.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/rampstackco/claude-skills /tmp/long-form-content-frameworks && cp -r /tmp/long-form-content-frameworks/dist/pi/.agents/skills/long-form-content-frameworks ~/.claude/skills/long-form-content-frameworks
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# 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
accessibility-auditSkill

Run a comprehensive WCAG accessibility audit covering perceivable, operable, understandable, and robust principles. Use this skill whenever the user wants to audit accessibility, review WCAG compliance, fix accessibility issues, prepare for accessibility certification, address an accessibility lawsuit risk, or systematically improve a site's accessibility. Triggers on accessibility audit, WCAG audit, a11y audit, accessibility compliance, ADA compliance, screen reader test, keyboard navigation, accessibility report, fix accessibility, axe scan. Also triggers when accessibility issues have been reported and need systematic remediation.

ads-creative-developmentSkill

How to produce ad creative that converts at performance scale. Hook patterns, format selection, video pacing, variation systems, sequential testing methodology, fatigue detection, brand-voice alignment without conversion dilution, and platform-specific creative norms. Triggers on ad creative, ad design, hook patterns, ad video pacing, creative testing, ad variations, creative refresh, creative fatigue, refresh ad creative, video ads for Meta, TikTok creative, LinkedIn ad creative, ad asset library. Also triggers when a team is producing creative at scale, planning a creative test cycle, or auditing why creative is not converting.

ads-performance-analyticsSkill

How to read paid media dashboards without fooling yourself. Attribution models, platform reporting quirks, multi-platform reconciliation, ROAS vs LTV horizon traps, statistical noise in performance metrics, incrementality testing, and the failure modes that produce expensive lessons. Triggers on read paid media dashboard, attribution analysis, ROAS vs LTV, multi-platform reconciliation, ad incrementality, geo holdout, conversion lift study, ghost bidding, paid media reporting, board-deck paid media metrics, blended CAC, MMM, MTA, last-click attribution. Also triggers when a marketer is about to scale, kill, or rebudget a campaign based on platform metrics, or when reconciling platform reports against warehouse revenue.

after-action-reportSkill

Run a structured after-action review (postmortem, retrospective) on a launch, incident, or completed project to capture timeline, root cause analysis, contributing factors, and actionable lessons. Use this skill whenever the user wants to run a postmortem, retrospective, AAR, or after-action review on any past event. Triggers on after-action report, AAR, postmortem, retrospective, retro, post-incident review, what went well what didn't, lessons learned, blameless postmortem, root cause analysis, RCA, five whys. Also triggers when the user has just shipped something or just resolved an incident and wants to capture learnings.

ai-content-collaborationSkill

How humans and AI compose in content workflows. Where AI legitimately participates, where humans must own, hybrid workflow patterns, voice ownership preservation, the AI slop problem, disclosure and transparency, team calibration, and the ethics of intellectually honest AI-assisted content production. Triggers on AI content workflow, AI-assisted writing, hybrid content production, AI in editorial, AI slop, AI disclosure, AI usage policy, AI content ethics, voice preservation with AI, team AI calibration. Also triggers when content feels generic despite quality tools, when team AI usage has drifted into inconsistency, or when a regulated or trust-sensitive context requires explicit AI policy.

analytics-strategySkill

Design measurement frameworks including event taxonomy, KPI hierarchy, dashboard architecture, attribution models, and analytics implementation strategy. Use this skill whenever the user wants to plan analytics, design dashboards, build event taxonomies, define KPIs, set up tracking, or audit existing measurement. Triggers on analytics strategy, measurement plan, event taxonomy, tracking plan, KPI framework, dashboard design, north star metric, attribution model, conversion tracking, GA4 setup, Mixpanel setup, analytics audit. Also triggers when the user has data but no clear way to use it, or wants to make decisions but doesn't know what to track.

art-directionSkill

Direct visual and creative work for campaigns, photography, illustration, video, and branded experiences. Use this skill whenever the user wants to brief a photographer, direct illustrators, plan a creative campaign, develop visual concepts, write a creative direction document, or evaluate creative work for fit. Triggers on art direction, photo brief, photography brief, illustration brief, campaign concept, creative concept, visual direction, mood board, look and feel, visual treatment, video direction. Also triggers when the user has approved brand identity but needs to extend it into specific creative deliverables.

backup-and-disaster-recoverySkill

Plan and run backups, set recovery objectives, and run disaster recovery drills. Use this skill when defining RPO/RTO targets, designing backup architecture, deciding what to back up and how often, planning for full-region or platform outages, or running a restoration drill. Triggers on backup, restore, RPO, RTO, disaster recovery, DR, business continuity, what if the database is gone, what if our hosting goes down, recovery drill, ransomware planning. Also triggers when an incident reveals a gap in restoration capability.