Article content skill
When the user wants to write, generate, or create article body content—blog post body, long-form content, how-to guide, listicle.
by kostja94·MIT license·★ 1,006 Stars on the repo·GitHub ↗
Use now
npx degit kostja94/marketing-skills/skills/content/article#main ~/.claude/skills/article-contentChecked ·commit main
Files of Article content
SKILL.md
Show the full text195 lines
Content: Article Content
Guides creation of article body content—the actual text (intro, body, conclusion) for blog posts, guides, and long-form pieces. Focus on what to write. For where it goes (page structure, schema, metadata), see article-page-generator. For short conversion copy (ads, landing pages, CTAs), see copywriting.
When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.
Scope
- Article body: Introduction, body sections, conclusion, CTA
- Content structure: Hook, QAE pattern, paragraph length, scannability
- Word count: By article type and search intent
- Writing frameworks: AIDA, PAS, BAB applied to articles
- GEO elements: TL;DR, Key Takeaways, answer-first
Article Types & Word Count (2025)
Quality over length: Google prioritizes comprehensive coverage of search intent, not word count. Match length to topic depth and intent.
| Type | Word count | Use case |
|---|---|---|
| News / announcements | 300–600 | Product updates, breaking news, FAQs |
| Short-form | 500–800 | Landing pages, product pages (scannable) |
| Standard articles / how-tos | 1,000–1,500 | Single topic; actionable; listicles |
| Listicles | 1,200–2,000 | "Top 10," "Best X"; numbered lists boost CTR ~70% |
| Cluster articles | 800–2,500 | Subtopic; links to pillar |
| Pillar / cornerstone | 2,000–3,500+ | Comprehensive; cluster hub; 6–12 sections |
| Competitive keywords | 1,800–2,500 | Page-one SEO posts avg ~2,400 words |
Intent-based (Google 2025): Validate 1,200–2,000; Explore 2,000–3,500; Compare 600–1,200; Do 900–1,500; Know 300–800. Informational ~40% longer than transactional.
Avoid: Under 300 words (thin); over 7,000 (often underperforms due to reduced focus).
Content Creation Workflow
Four Inputs
Article content rests on four inputs. See article-page-generator for full workflow.
| Input | Purpose |
|---|---|
| Product | Connection, features, CTA placement |
| Keywords | Target keyword, primary/secondary |
| Article intent | Informational, commercial, transactional |
| Competitor articles | Structure to adopt, content gaps, length target |
Information Gain (Content Density Over Word Count)
Information gain = net new information a page provides beyond what exists in top-ranking results. Google evaluates unique value, not comprehensiveness. Content density (unique entities, data points, insights per 100 words) matters more than word count. Skyscraper Technique (longer = better) no longer differentiates; AI made comprehensiveness cheap.
Four sources of information gain:
- Counter-narratives: Why "best practice" fails in certain contexts; evidence-backed
- Temporal freshness: Data or developments after competitors' content and LLM cutoff
- SME perspectives: Direct quotes, practitioner experience; not repackaged advice
- Proprietary data: Original surveys, internal benchmarks, user behavior patterns
Avoid consensus content: Restating common facts across top 10 results = zero information gain. Audit SERP before writing; list the "consensus layer"; identify gaps (unanswered questions, outdated data, underserved segments). Lead with what is new; structure answer-first.
Density check: Count unique data points, original insights, specific claims. If ratio of new information to word count is low, cut filler. High-density content (800-1,500 words with 3+ original points) often outperforms long rehashed guides.
TL;DR or Key Takeaways (GEO)
Choose one; place after intro. Content with these elements tends to be cited more frequently by AI engines.
| Format | Spec |
|---|---|
| TL;DR | 50–100 word bold summary paragraph |
| Key Takeaways | 5–7 bullet points |
See generative-engine-optimization for full GEO strategy.
Introduction
Length: 40–120 words; 2–3 paragraphs. Readers decide in ~8 seconds; hook must work instantly.
| Element | Guideline |
|---|---|
| Hook | First 1–2 sentences: pain point, stat, or question; curiosity gap; specific data or contrarian fact |
| Primary keyword | In first 100 words |
| Expectations | Set what reader will learn |
Hook types: "You're doing X wrong"; "97% of Y…"; bold question; challenge assumption. Well-crafted hooks boost CTR 30–50%.
Body
| Element | Guideline |
|---|---|
| QAE pattern | Question (H2) → Answer (2 sentences) → Evidence (data, examples, lists) |
| Answer-first | Direct answer in first 40–60 words after each H2 |
| Answer blocks | 100–200 words per section; direct answer + context + evidence |
| Paragraph length | 40–80 words; 2–4 sentences; avoid walls of text |
| Break long blocks | Lists, H3s, images, callout boxes every 2–3 paragraphs |
| Scannability | Front-load key info (F-pattern); bold key phrases; one idea per paragraph |
Long-form (1,000+ words): Place engagement hooks every 500–600 words; mix 40–50% explanatory text, 20–25% examples, 10–15% data, 5–10% visuals.
Conclusion
Summary + CTA: newsletter signup, related content, product (link to product/feature when relevant). Product-linked content ties to product naturally.
Product Connection
Articles should tie to the product (problem it solves, features, use cases). Avoid purely generic content. Link to product/feature pages naturally in conclusion or when context fits.
Writing Frameworks
Apply copywriting frameworks to article structure. See copywriting for full PAS, AIDA, BAB.
| Framework | Article use |
|---|---|
| AIDA | Intro (Attention); body (Interest, Desire); conclusion (Action/CTA) |
| PAS | How-to guides: Problem in intro; Agitation in body; Solution throughout |
| BAB | Case studies, transformation: Before → After → Bridge |
Choose by audience: AIDA for ready-to-buy; PAS for pain-driven; BAB for transformation seekers.
Article Headlines
See copywriting for headline formulas (How to, Number, Problem→Solution). For article titles specifically:
- Length: 50–60 chars; see title-tag
- Primary keyword near start
- Numbers and power words boost CTR ~36%
References & Citations
| Scenario | Practice |
|---|---|
| Data or statistics | Cite inline (e.g. "According to Source, 72% of…") or in References section |
| Expert quotes | Attribute; link to source |
| Reference section | For 5+ citations; list at end before Related posts |
| Format | Inline links preferred; numbered refs [1], [2] for academic-style |
See eeat-signals for E-E-A-T, author bio, citations, YMYL.
Content Quality
| Element | Guideline |
|---|---|
| Readability | Grade 8–10 (Flesch-Kincaid); short sentences, clear language |
| Depth | Match type; comprehensive coverage over padding |
| Originality | Unique angle, data, examples; avoid thin or rehashed content |
| Information gain | What does this add that top 10 results don't? Counter-narrative, fresh data, SME quote, or proprietary insight |
| E-E-A-T | Author bio, citations, expert quotes — see eeat-signals |
Content Audit Checklist
When auditing or optimizing article content:
| Dimension | Check |
|---|---|
| Hook | Intro opens with pain point, stat, or question? |
| Keyword in first 100 words | Primary keyword present? |
| QAE pattern | H2s as questions? Answer-first (40–60 words) in each section? |
| Word count | Matches type? (300–600 news, 1,000–2,500 cluster, 2,500+ pillar) |
| Paragraph length | 40–80 words per paragraph? No walls of text? |
| Product connection | Ties to product? Natural links to features/pricing? |
| CTA | Placement (conclusion, mid-article); clarity; product link |
| References | Data/stats cited? Reference section for 5+ citations? |
| Gaps | What do top-ranking articles cover that this misses? |
| Information gain | At least one of: counter-narrative, fresh data, SME perspective, proprietary data? Or consensus rehash? |
See competitor-research for competitor analysis; article-page-generator for page structure and metadata.
AI-Assisted Content
When content is AI-assisted: human review before publish; verify facts and add citations; original insights or data; avoid generic phrasing. See eeat-signals for E-E-A-T and AI content guidance.
Output Format
- Outline (H2s with keyword placement)
- TL;DR or Key Takeaways (if SEO-driven)
- Introduction (hook + keyword)
- Body sections (QAE, answer-first)
- Conclusion (summary + CTA)
- CTA copy options
Related Skills
- article-page-generator: Page structure, schema, metadata, layout; content goes here
- howto-section-generator: Dedicated HowTo step blocks (ordered steps, HowTo JSON-LD; vs FAQ)
- copywriting: Frameworks (PAS, AIDA, BAB); headline formulas; short conversion copy
- content-marketing: Article Orientations; content types
- eeat-signals: E-E-A-T; author bio; citations; citations format
- keyword-research: Keyword basis; search intent
- competitor-research: Content gaps; structure to adopt; SERP audit for information gain
- content-optimization: H2 keywords; Multimedia (tables, lists); keyword density
- generative-engine-optimization: GEO strategy; AI citation
| 1 | |
| 2 | name article-content |
| 3 | description When the user wants to write, generate, or create article body content—blog post body, long-form content, how-to guide, listicle. Also use when the user mentions "write article," "article content," "blog post content," "article body," "long-form content creation," "generate article," "article draft," "how-to guide content," "listicle content," "information gain," or "content density." For single post page structure, schema, and SEO metadata, use article-page-generator. For blog index/listing page, use blog-page-generator. For short ad, landing, or email copy, use copywriting. |
| 4 | metadata |
| 5 | version 1.1.1 |
| 6 | |
| 7 | |
| 8 | # Content: Article Content |
| 9 | |
| 10 | Guides creation of **article body content**—the actual text (intro, body, conclusion) for blog posts, guides, and long-form pieces. Focus on **what to write**. For **where it goes** (page structure, schema, metadata), see **article-page-generator**. For short conversion copy (ads, landing pages, CTAs), see **copywriting**. |
| 11 | |
| 12 | **When invoking**: On **first use**, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output. |
| 13 | |
| 14 | ## Scope |
| 15 | |
| 16 | **Article body**: Introduction, body sections, conclusion, CTA |
| 17 | **Content structure**: Hook, QAE pattern, paragraph length, scannability |
| 18 | **Word count**: By article type and search intent |
| 19 | **Writing frameworks**: AIDA, PAS, BAB applied to articles |
| 20 | **GEO elements**: TL;DR, Key Takeaways, answer-first |
| 21 | |
| 22 | ## Article Types & Word Count (2025) |
| 23 | |
| 24 | **Quality over length**: Google prioritizes comprehensive coverage of search intent, not word count. Match length to topic depth and intent. |
| 25 | |
| 26 | | Type | Word count | Use case | |
| 27 | |------|------------|----------| |
| 28 | | **News / announcements** | 300–600 | Product updates, breaking news, FAQs | |
| 29 | | **Short-form** | 500–800 | Landing pages, product pages (scannable) | |
| 30 | | **Standard articles / how-tos** | 1,000–1,500 | Single topic; actionable; listicles | |
| 31 | | **Listicles** | 1,200–2,000 | "Top 10," "Best X"; numbered lists boost CTR ~70% | |
| 32 | | **Cluster articles** | 800–2,500 | Subtopic; links to pillar | |
| 33 | | **Pillar / cornerstone** | 2,000–3,500+ | Comprehensive; cluster hub; 6–12 sections | |
| 34 | | **Competitive keywords** | 1,800–2,500 | Page-one SEO posts avg ~2,400 words | |
| 35 | |
| 36 | **Intent-based** (Google 2025): Validate 1,200–2,000; Explore 2,000–3,500; Compare 600–1,200; Do 900–1,500; Know 300–800. Informational ~40% longer than transactional. |
| 37 | |
| 38 | **Avoid**: Under 300 words (thin); over 7,000 (often underperforms due to reduced focus). |
| 39 | |
| 40 | ## Content Creation Workflow |
| 41 | |
| 42 | ### Four Inputs |
| 43 | |
| 44 | Article content rests on **four inputs**. See **article-page-generator** for full workflow. |
| 45 | |
| 46 | | Input | Purpose | |
| 47 | |-------|---------| |
| 48 | | **Product** | Connection, features, CTA placement | |
| 49 | | **Keywords** | Target keyword, primary/secondary | |
| 50 | | **Article intent** | Informational, commercial, transactional | |
| 51 | | **Competitor articles** | Structure to adopt, content gaps, length target | |
| 52 | |
| 53 | ### Information Gain (Content Density Over Word Count) |
| 54 | |
| 55 | **Information gain** = net new information a page provides beyond what exists in top-ranking results. Google evaluates unique value, not comprehensiveness. Content density (unique entities, data points, insights per 100 words) matters more than word count. Skyscraper Technique (longer = better) no longer differentiates; AI made comprehensiveness cheap. |
| 56 | |
| 57 | **Four sources of information gain**: |
| 58 | **Counter-narratives**: Why "best practice" fails in certain contexts; evidence-backed |
| 59 | **Temporal freshness**: Data or developments after competitors' content and LLM cutoff |
| 60 | **SME perspectives**: Direct quotes, practitioner experience; not repackaged advice |
| 61 | **Proprietary data**: Original surveys, internal benchmarks, user behavior patterns |
| 62 | |
| 63 | **Avoid consensus content**: Restating common facts across top 10 results = zero information gain. Audit SERP before writing; list the "consensus layer"; identify gaps (unanswered questions, outdated data, underserved segments). Lead with what is new; structure answer-first. |
| 64 | |
| 65 | **Density check**: Count unique data points, original insights, specific claims. If ratio of new information to word count is low, cut filler. High-density content (800-1,500 words with 3+ original points) often outperforms long rehashed guides. |
| 66 | |
| 67 | ### TL;DR or Key Takeaways (GEO) |
| 68 | |
| 69 | Choose one; place after intro. Content with these elements tends to be cited more frequently by AI engines. |
| 70 | |
| 71 | | Format | Spec | |
| 72 | |--------|------| |
| 73 | | **TL;DR** | 50–100 word bold summary paragraph | |
| 74 | | **Key Takeaways** | 5–7 bullet points | |
| 75 | |
| 76 | See **generative-engine-optimization** for full GEO strategy. |
| 77 | |
| 78 | ### Introduction |
| 79 | |
| 80 | **Length**: 40–120 words; 2–3 paragraphs. Readers decide in ~8 seconds; hook must work instantly. |
| 81 | |
| 82 | | Element | Guideline | |
| 83 | |---------|-----------| |
| 84 | | **Hook** | First 1–2 sentences: pain point, stat, or question; curiosity gap; specific data or contrarian fact | |
| 85 | | **Primary keyword** | In first 100 words | |
| 86 | | **Expectations** | Set what reader will learn | |
| 87 | |
| 88 | **Hook types**: "You're doing X wrong"; "97% of Y…"; bold question; challenge assumption. Well-crafted hooks boost CTR 30–50%. |
| 89 | |
| 90 | ### Body |
| 91 | |
| 92 | | Element | Guideline | |
| 93 | |---------|-----------| |
| 94 | | **QAE pattern** | Question (H2) → Answer (2 sentences) → Evidence (data, examples, lists) | |
| 95 | | **Answer-first** | Direct answer in first 40–60 words after each H2 | |
| 96 | | **Answer blocks** | 100–200 words per section; direct answer + context + evidence | |
| 97 | | **Paragraph length** | 40–80 words; 2–4 sentences; avoid walls of text | |
| 98 | | **Break long blocks** | Lists, H3s, images, callout boxes every 2–3 paragraphs | |
| 99 | | **Scannability** | Front-load key info (F-pattern); **bold** key phrases; one idea per paragraph | |
| 100 | |
| 101 | **Long-form (1,000+ words)**: Place engagement hooks every 500–600 words; mix 40–50% explanatory text, 20–25% examples, 10–15% data, 5–10% visuals. |
| 102 | |
| 103 | ### Conclusion |
| 104 | |
| 105 | **Summary** + **CTA**: newsletter signup, related content, **product** (link to product/feature when relevant). Product-linked content ties to product naturally. |
| 106 | |
| 107 | ### Product Connection |
| 108 | |
| 109 | Articles should tie to the product (problem it solves, features, use cases). Avoid purely generic content. Link to product/feature pages naturally in conclusion or when context fits. |
| 110 | |
| 111 | ## Writing Frameworks |
| 112 | |
| 113 | Apply **copywriting** frameworks to article structure. See **copywriting** for full PAS, AIDA, BAB. |
| 114 | |
| 115 | | Framework | Article use | |
| 116 | |-----------|-------------| |
| 117 | | **AIDA** | Intro (Attention); body (Interest, Desire); conclusion (Action/CTA) | |
| 118 | | **PAS** | How-to guides: Problem in intro; Agitation in body; Solution throughout | |
| 119 | | **BAB** | Case studies, transformation: Before → After → Bridge | |
| 120 | |
| 121 | **Choose by audience**: AIDA for ready-to-buy; PAS for pain-driven; BAB for transformation seekers. |
| 122 | |
| 123 | ## Article Headlines |
| 124 | |
| 125 | See **copywriting** for headline formulas (How to, Number, Problem→Solution). For article titles specifically: |
| 126 | |
| 127 | **Length**: 50–60 chars; see **title-tag** |
| 128 | **Primary keyword** near start |
| 129 | **Numbers** and power words boost CTR ~36% |
| 130 | |
| 131 | ## References & Citations |
| 132 | |
| 133 | | Scenario | Practice | |
| 134 | |----------|----------| |
| 135 | | **Data or statistics** | Cite inline (e.g. "According to [Source], 72% of…") or in References section | |
| 136 | | **Expert quotes** | Attribute; link to source | |
| 137 | | **Reference section** | For 5+ citations; list at end before Related posts | |
| 138 | | **Format** | Inline links preferred; numbered refs [1], [2] for academic-style | |
| 139 | |
| 140 | See **eeat-signals** for E-E-A-T, author bio, citations, YMYL. |
| 141 | |
| 142 | ## Content Quality |
| 143 | |
| 144 | | Element | Guideline | |
| 145 | |---------|-----------| |
| 146 | | **Readability** | Grade 8–10 (Flesch-Kincaid); short sentences, clear language | |
| 147 | | **Depth** | Match type; comprehensive coverage over padding | |
| 148 | | **Originality** | Unique angle, data, examples; avoid thin or rehashed content | |
| 149 | | **Information gain** | What does this add that top 10 results don't? Counter-narrative, fresh data, SME quote, or proprietary insight | |
| 150 | | **E-E-A-T** | Author bio, citations, expert quotes — see **eeat-signals** | |
| 151 | |
| 152 | ## Content Audit Checklist |
| 153 | |
| 154 | When auditing or optimizing article content: |
| 155 | |
| 156 | | Dimension | Check | |
| 157 | |-----------|-------| |
| 158 | | **Hook** | Intro opens with pain point, stat, or question? | |
| 159 | | **Keyword in first 100 words** | Primary keyword present? | |
| 160 | | **QAE pattern** | H2s as questions? Answer-first (40–60 words) in each section? | |
| 161 | | **Word count** | Matches type? (300–600 news, 1,000–2,500 cluster, 2,500+ pillar) | |
| 162 | | **Paragraph length** | 40–80 words per paragraph? No walls of text? | |
| 163 | | **Product connection** | Ties to product? Natural links to features/pricing? | |
| 164 | | **CTA** | Placement (conclusion, mid-article); clarity; product link | |
| 165 | | **References** | Data/stats cited? Reference section for 5+ citations? | |
| 166 | | **Gaps** | What do top-ranking articles cover that this misses? | |
| 167 | | **Information gain** | At least one of: counter-narrative, fresh data, SME perspective, proprietary data? Or consensus rehash? | |
| 168 | |
| 169 | See **competitor-research** for competitor analysis; **article-page-generator** for page structure and metadata. |
| 170 | |
| 171 | ## AI-Assisted Content |
| 172 | |
| 173 | When content is AI-assisted: **human review** before publish; **verify facts** and add citations; **original insights** or data; avoid generic phrasing. See **eeat-signals** for E-E-A-T and AI content guidance. |
| 174 | |
| 175 | ## Output Format |
| 176 | |
| 177 | **Outline** (H2s with keyword placement) |
| 178 | **TL;DR or Key Takeaways** (if SEO-driven) |
| 179 | **Introduction** (hook + keyword) |
| 180 | **Body** sections (QAE, answer-first) |
| 181 | **Conclusion** (summary + CTA) |
| 182 | **CTA copy** options |
| 183 | |
| 184 | ## Related Skills |
| 185 | |
| 186 | **article-page-generator**: Page structure, schema, metadata, layout; content goes here |
| 187 | **howto-section-generator**: Dedicated HowTo step blocks (ordered steps, HowTo JSON-LD; vs FAQ) |
| 188 | **copywriting**: Frameworks (PAS, AIDA, BAB); headline formulas; short conversion copy |
| 189 | **content-marketing**: Article Orientations; content types |
| 190 | **eeat-signals**: E-E-A-T; author bio; citations; citations format |
| 191 | **keyword-research**: Keyword basis; search intent |
| 192 | **competitor-research**: Content gaps; structure to adopt; SERP audit for information gain |
| 193 | **content-optimization**: H2 keywords; Multimedia (tables, lists); keyword density |
| 194 | **generative-engine-optimization**: GEO strategy; AI citation |
| 195 |
Discussion
Alternatives
Turn a pile of notes into an articleHand over your messy notes, transcripts and half-thoughts on a topic, and get back a finished article that flows from one point to the next.
End-of-Article CTA DesignerDesigns end-of-article CTAs — copy, layout, placement, A/B test plan, accessibility — for blog posts, newsletters, and essays. Use whenever the user asks to write, review, or improve a CTA at the bottom of an article; mentions "end-of-post CTA", "call-to-action", "signup box", "newsletter CTA", "subscribe block", or "what should I put at the bottom"; or asks how to turn readers into subscribers, leads, customers, or paying supporters. Covers personal blogs, paid newsletters (Substack, beehiiv, Ghost), and brand content-marketing blogs. Do NOT use for opening hooks, ledes, or post titles — use samber/cc-skills@copywriting-hooks instead. Not for landing-page, ad, or email copy.Article summary and comprehensionSummarize and understand articles by extracting key points and providing comprehension insights.Cinematic video essay directorAn advanced prompt that transforms a basic video idea into a fully structured, high-retention video essay. It scripts the visual B-roll, pacing, emotional beats, and a captivating narrative framework for YouTube or documentaries.Browse more free Claude skills or everything in Content creator.