/seo-content-homepage

name: seo-content-homepage
description: "Runs spec, audit, competitor benchmark and build for the homepage and the flagship offer page (sales page) of an expert, coach, trainer, agency, consultant or SaaS, so they rank, get cited by AI engines and convert. Phase 1 is the spec: HOME and OFFER requirement tables (the 16 homepage blocks, the sales page sequence, semantic bolding, a number in every block, an objection FAQ, a visible price, dated ratings, checkable credentials, real social profiles, honest claims and regulated-topic notices) on top of the common page spec. Phase 2 audits the live home, offer and about pages with seo_audit.py and section_audit.py. Phase 3 benchmarks 3-5 competitors with page_benchmark.py and picks the information gain. Phase 4 writes the copy block by block with Organization, WebSite, Person and Course or Service JSON-LD, then re-runs the scripts as the acceptance test. Use when a homepage or sales page is thin, has no bold, no numbers, no proof, only a generic FAQ, or is being built from scratch."
license: MIT
metadata:
  author: "Sorank (https://sorank.com)"
  version: "2.0.0"

Homepage and offer page that rank, get cited and sell

The homepage is the strongest page of a small site: most backlinks land there, every branded search lands there, and AI assistants answering "who is {brand}" or "best {category} coach" read it first. The flagship offer page is where the money is made. On expert and coaching sites both are usually a stack of slogans, three icons, a video and a generic FAQ ("What is poker?"): 800 words, no bold, no numbers, no structured data. That page cannot rank on the category term, gives an AI engine nothing to quote and gives a buyer no reason to trust.

This skill fixes that in four phases (spec, audit, benchmark, build, see `docs/page-skill-standard.md`) with a measurable finish line.

Company knowledge first (Obsidian)

If the working environment contains an Obsidian vault or any local knowledge base (a folder of .md notes, often with a .obsidian directory), read the relevant notes before writing: offer facts, real prices, real client results, founder story and credentials, positioning, competitors, social profile URLs, and the SEO action log. Every block of a homepage asserts facts about the business, so invented numbers are the main failure mode. At the end of the session, append what was published to the vault's SEO action log. Vault structure and protocols: the obsidian-brain skill.

When to use

• A homepage or sales page is thin, slogan-only, or has only a generic FAQ.
• An audit (`seo_audit.py`) reports `no_bold`, `thin_content`, `schema_none`, `schema_entity`, `home_no_money_links`, `social_placeholder` or a low placement coverage on the homepage.
• A site is being built from scratch, or generated by an agent, and the block list must be decided first.
• The owner asks "what are my competitors doing that I am not".

| Adjacent need | Skill | |---|---| | Service pages and city pages | seo-content-service-page | | Articles, the blog hub and article templates | seo-content-blog | | Block-by-block gap audit of any other page type; the pricing, about and contact wireframes | seo-page-sections (`references/transverse-pages.md`) | | JSON-LD fields and templates (Course template included) | seo-schema-markup | | Choosing the category term and its variants | seo-keyword-research | | "{brand} vs {competitor}" and alternatives pages | seo-content-comparison-page | | Which brands AI assistants name, citation tracking | geo-visibility, geo-tracking |

Phase 1. The spec

1.1 Facts the spec needs

Ask for, or pull from the vault, before writing a line. Missing facts become visible placeholders `{to confirm}`, never inventions.

| Fact | Used in | |---|---| | Category term and its search variants (what buyers type: "coaching poker", "formation poker", "agence SEO Lyon") | Title, H1, first 100 words, H2s (HOME-20) | | The outcome promised, with a number and a timeframe | Hero sub-line, results block (HOME-02, HOME-07) | | Proof numbers: clients served, years, results, ratings with their platform and count | Proof strip, results, founder block (HOME-03, HOME-22, HOME-25) | | 3-6 client results with first name, starting point, result, timeframe; video testimonials | Results and testimonials (HOME-07, HOME-08) | | Founder credentials that can be checked (years, track record, press, certifications, public profiles) | Founder block, Person schema (HOME-09, HOME-26) | | The offer: format, contents, time commitment, price or price range, guarantee, process to join | Offer cards, sales page (HOME-06, OFFER-05 to OFFER-14) | | Real social profile URLs (LinkedIn, YouTube, Instagram, X, TikTok, community) | Footer, founder block, `sameAs` (HOME-27) | | The 8-12 objections prospects actually raise (sales calls, emails, DMs, comments) | FAQ (HOME-15, OFFER-16) |

1.2 Homepage requirements (HOME)

Common requirements C-01 to C-27: skills/seo-geo-audit/references/common-page-spec.md. They apply to all three pages and are not repeated here. Thresholds are field heuristics from 115+ agency audits unless marked measured; "14 sites" counts come from the October 2026 coaching benchmark in `references/block-library.md` section 5. Block details (minimum spec per block) live in `references/block-library.md` section 1, same numbering.

| ID | Requirement | Threshold | Verified by | Why | |---|---|---|---|---| | HOME-01 | Header | Logo, 4-6 menu items (offers, results, about, blog, contact), one CTA button in a contrasting color, sticky | section_audit `cta`; manual | The CTA stays visible at every scroll position | | HOME-02 | Hero | H1 = **category term** + outcome, never a slogan; sub-line with one proof number; primary CTA (main conversion) and secondary CTA (low commitment: free training, guide, quiz); real founder or product image, eager-loaded | h1_missing, kw_not_in_intro, lcp_lazy; manual for the outcome | The first screen answers what, fo