Skip to content

aaron-he-zhu/aaron-marketing-skills / seo-geo/implement/content-writer

content-writer

Verified

Use when the user asks to "write SEO content", "draft a blog post / landing page", "update outdated content", or "fix traffic/ranking decay"; two modes — new drafts pages with keywords, headers, snippets, and evidence boundaries; refresh scores decay, prioritizes update work, and produces a republish plan with GEO guidance. Not for AI-citation/GEO readiness scoring — use geo-content-optimizer; not for publish-gate scoring — use content-quality-auditor. SEO文章写作/内容更新/排名恢复

references/title-formulas.md

View on GitHub
# Title and Headline Formulas

Use these copy-start patterns to write titles that match intent, earn clicks, and stay within SERP display limits. Default target: **50-60 characters**; mobile-heavy pages should aim for **50-55 characters**.

## Formula Matrix

| Intent | Pattern | Best for | Example shape |
|--------|---------|----------|---------------|
| List | `[N] [Adjective] [Topic] [Benefit]` | Roundups, tactics, tools | `7 Proven SEO Tests for Faster Indexing` |
| How-to | `How to [Goal] in [Timeframe]` | Tutorials, workflows | `How to Build Topic Clusters in 30 Days` |
| How-to with objection | `How to [Goal] Without [Pain]` | Barrier removal | `How to Grow Traffic Without Paid Ads` |
| Beginner | `How to [Goal] (Even If [Limitation])` | New audience | `How to Rank Locally (Even with a New Site)` |
| Definition | `What Is [Topic]? [Benefit/Hook]` | Educational queries | `What Is Technical SEO? A Practical Guide` |
| Why | `Why [Problem/Action] [Result]` | Diagnosis, contrarian angles | `Why Most SEO Audits Miss Crawl Waste` |
| Decision | `Should You [Action]? [Quick Answer]` | Risk or purchase questions | `Should You Buy Backlinks? The Safer Answer` |
| Comparison | `[A] vs [B]: Which Is Better for [Use Case]?` | Commercial investigation | `WordPress vs Webflow: Which Is Better for SEO?` |
| Alternatives | `[N] Best [Product] Alternatives in [Year]` | Tool switching | `7 Best Ahrefs Alternatives in 2026` |
| Guide | `The [Complete/Definitive] Guide to [Topic]` | Pillar content | `The Complete Guide to Technical SEO` |
| Audience guide | `[Topic]: The Ultimate Guide for [Audience]` | Segment-specific pages | `Local SEO: The Ultimate Guide for Clinics` |
| Before/after | `From [Bad State] to [Good State]: [Proof/Method]` | Case studies | `From 0 to 10K Visits: The Content System` |
| Mistake | `[N] [Topic] Mistakes [Consequence]` | Remediation | `5 SEO Mistakes Killing Product Pages` |
| Fix | `Why Your [Topic] Is Not Working (And How to Fix It)` | Troubleshooting | `Why Your Content Is Not Ranking (And How to Fix It)` |
| Checklist | `[Topic] Checklist: [N] Must-Check Items` | Audits, implementation | `Technical SEO Checklist: 23 Must-Check Items` |

## CTR Modifiers

| Modifier type | Use when | Examples |
|---------------|----------|----------|
| Freshness | Topic changes over time | `2026`, `Updated`, `Current` |
| Proof | Claim needs credibility | `Tested`, `Proven`, `With Data` |
| Completeness | Page is a definitive resource | `Complete`, `Essential`, `Definitive` |
| Speed | User needs fast action | `Quick`, `Fast`, `Today` |
| Audience | SERP has segmented intent | `for Beginners`, `for B2B`, `for SaaS` |
| Cost | Tool or buyer intent | `Free`, `Low-Cost`, `Budget` |

Avoid all caps, excessive punctuation, unsupported superlatives, vague clickbait, and promises the content does not fulfill.

## Length Guidelines

| Surface | Optimal | Truncation risk |
|---------|---------|-----------------|
| Google desktop SERP | 50-60 chars | Around 70 chars |
| Google mobile SERP | 50-55 chars | Around 55 chars |
| Email subject | 40-50 chars | Around 60 chars |
| Facebook | 40-50 chars | Context dependent |
| Twitter/X | 70-100 chars | Context dependent |

## Rewrite Examples

| Weak title | Stronger title | Why it works |
|------------|----------------|--------------|
| `SEO Tips` | `How We Increased Organic Traffic by [X]% in [timeframe]` | First-party proof with placeholders |
| `How to Do Keyword Research` | `How to Do Keyword Research with Free Tools` | Adds constraint and value |
| `Content Marketing Guide` | `The Complete Content Marketing Guide for SMBs` | Defines scope and audience |
| `WordPress vs Shopify` | `WordPress vs Shopify: Which Is Better for SEO?` | Adds decision frame |

## Title QA

- [ ] Primary keyword appears naturally.
- [ ] Search intent and content format match the SERP.
- [ ] Title is specific, truthful, and concrete.
- [ ] Length fits the target surface.
- [ ] Modifier adds real value, not clickbait.
- [ ] Mobile truncation still leaves the main promise clear.
- [ ] Title is meaningfully different from top competitors.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 196kUpdated Claude CodeCodexVerifiedInstall