content-templates

name	content-templates
description	Structure templates for blog posts, social snippets, email newsletters, and other content formats. Use when drafting marketing or distribution content and needing correct channel-specific structure.

Content Templates

Templates and structure guidelines for creating content across channels.

Blog Post Structure

1. Headline — clear, benefit-driven, includes primary keyword (≤ 60 characters for SEO)
2. Introduction (100–150 words) — hook with question, stat, bold claim, or scenario; state what's covered; include primary keyword
3. Body sections (3–5 sections) — each with H2 subheading; one core idea per section with evidence, examples, or data
4. Conclusion (75–100 words) — key takeaways, reinforce main message, call to action
5. Meta description — under 160 characters, includes primary keyword, compels click

Social Media Structure

• Hook — first line grabs attention (question, bold statement, number)
• Body — 2–4 concise points or short narrative
• CTA — what should the reader do next (comment, click, share, tag)
• Hashtags — 3–5 relevant (platform-dependent; LinkedIn: 3 max; Twitter: 1–2)

Email Newsletter Structure

• Subject line — under 50 characters, creates curiosity or states clear value
• Preview text — complements subject, does not repeat it
• Header — visual anchor and one-line value statement
• Body — 2–3 content blocks, each scannable with a bold intro sentence
• Primary CTA — one clear action per email
• Footer — unsubscribe link, company info, social links

Channel Guidelines

LinkedIn

• Professional but human; paragraph breaks for readability
• Personal stories and lessons perform well
• 1,300 characters is the sweet spot before "see more"
• 3 hashtags max

Twitter/X

• Concise and punchy; strong opening words
• Threads for longer narratives
• First tweet must hook independently (people RT without reading thread)

Blog

• Write for technical professionals (Flesch-Kincaid grade 10–14 for ArtStroy)
• Short paragraphs (2–4 sentences)
• Subheadings every 200–300 words
• Include at least one data point per section
• Active voice throughout
• Front-load key information in each section

Headline Formulas

• How to [achieve result] without [common obstacle] — "How to Double Playwright Coverage Without Slowing CI"
• [Number] [adjective] ways to [achieve result] — "5 Ways to Reduce OWASP Findings in Node.js APIs"
• Why [common belief] is wrong (and what to do instead)
• [Do this], not [that] — "Test the API, Not the Mock"
• [Topic]: what [audience] needs to know — "CSP Headers: What QA Engineers Need to Know"

Hook Formulas (Opening Lines)

• Surprising statistic: "73% of QA teams say their biggest bottleneck is flaky tests, not test coverage."
• Contrarian statement: "The best pentesting report is the one that makes developers angry."
• Question: "When was the last time your CI pipeline caught a security regression?"
• Bold claim: "Most Playwright selectors break not because of Playwright — because of the tests."

CTA Best Practices

• Use action verbs: "Get", "Start", "Download", "Join", "Try", "See"
• Be specific: "Read the full OWASP guide" is better than "Learn more"
• Reduce risk: "No login required", "All examples are open source"
• One primary CTA per page or email

SEO Fundamentals

• One primary keyword + 2–3 secondary keywords per piece
• Primary keyword in: headline, first paragraph, one subheading, meta description
• Use secondary keywords naturally in body and subheadings
• Do not keyword-stuff — write for humans first
• Internal links: 2–3 links to related ArtStroy articles
• External links: 1–2 links to authoritative sources