Long-Form Article Writer

Article content

by kostja94 · MIT license · ★ 1,006 on GitHub

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,"…

---
name: article-content
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.
metadata:
  version: 1.1.1
---

# 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

Overview

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.

What you get

Outline(H2s with keyword placement)
TL;DR or Key Takeaways(if SEO-driven)
Introduction(hook + keyword)
Bodysections (QAE, answer-first)
Conclusion(summary + CTA)
CTA copyoptions

Manual install (npx, ZIP)

Claude Codenpx skills add kostja94/marketing-skills --skill article-content -g -a claude-code

Claude Code (degit)npx degit kostja94/marketing-skills/skills/content/article#main ~/.claude/skills/article-content

Claude.ai / desktopZip the folder and upload it under Settings → Capabilities → Skills.

Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

SKILL.md10.2 KB

Read SKILL.md here

kostja94/main1 file shown

SKILL.md10.2 KB

Browse every file on GitHub↗

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

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](url), 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