heymegabyte/agent-skills / 09-brand-and-content-system
brand-and-content-system
VerifiedExtract real brands (Wayback for rebuilds). Copy system, headline/CTA rules, trust surfaces, legal pages, SEO+structured data, anti-AI-slop, microcopy, DESIGN.md, W3C DTCG tokens, pSEO 5 types, GEO/AI search.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 12.2 KB |
| ai-search-geo.md | markdown | 4.0 KB |
| build-breaking-rules.md | markdown | 21.0 KB |
| documentation-and-codebase-hygiene.md | markdown | 3.1 KB |
| email-templates.md | markdown | 6.0 KB |
| grammar-audit.md | markdown | 3.7 KB |
| per-route-metadata.md | markdown | 6.8 KB |
| seo-and-keywords.md | markdown | 6.3 KB |
| social-automation.md | markdown | 5.8 KB |
seo-and-keywords.md
View on GitHub---
name: "SEO and Keywords"
version: "1.2.0"
updated: "2026-04-23"
description: "Full SEO engine: keyword research, competitor analysis, per-page primary+longtail targeting, Yoast-level checks, schema markup, internal linking, pSEO at scale. Runs every build."
---
# SEO and Keywords
Every page targets: 1 holy-grail keyword (high-volume) + 1-2 longtail phrases (lower competition, high intent) + semantic variations woven naturally.
## Keyword Research Workflow
### Step 1: Seed from Product
`Domain → category → features → user problems`. E.g. `"instantidle.com" → container deployment → "docker hosting" → "cheap docker hosting"`.
### Step 2: Expand with APIs
#### Google Autocomplete (FREE, no key)
```typescript
async function getAutocompleteSuggestions(seed: string): Promise<string[]> {
const url = `https://suggestqueries.google.com/complete/search?client=firefox&q=${encodeURIComponent(seed)}`;
const [, suggestions] = await (await fetch(url)).json();
return suggestions;
}
// Expand with alphabet modifiers: `${seed} a`, `${seed} b`, etc.
```
#### Other tools
- **DataForSEO** (~$0.01/keyword) — volume, CPC, competition, trends
- **Google Search Console** (FREE) — real clicks, impressions, position
- **Google Trends** — relative interest over time
### Step 3: Competitor Analysis
1. Identify 3-5 competitors
2. Scrape `sitemap.xml` → fetch pages → extract title / h1 / meta
3. Find gaps (keywords they rank for that we don't) + easy wins (high volume + low competition)
### Step 4: Selection Matrix
- **Holy-grail** — highest volume relevant keyword
- **Longtail 1** — lower competition, commercial intent
- **Longtail 2** — informational intent, blog / resource page
## Per-Page Yoast Checklist (ALL GREEN)
- **Title** — 50-60 chars, keyword at start, unique, includes brand. Format: `{Keyword} — {Supporting} | Brand`
- **Meta description** — 120-156 chars, contains keyword, includes CTA, unique per page
- **URL** — short, readable, keyword-rich, lowercase, hyphens. Good: `/docker-hosting`
- **Headings** — one H1 with keyword; H2s with longtail/semantic variations; logical hierarchy; no skipped levels
- **Content** — keyword in first 100 words; density 0.4-2.2% (natural diagnostic, never stuffed); **2,000–3,000+ substantive editorial words for blog & reference articles** (per `skills/blog-publishing/SKILL.md` — never 600–900 word thin posts; `1,500–2,000+` words for pSEO/landing pages); Flesch ≥60; short paragraphs (2-4 sentences); subheadings every 200-300 words; transition words ≥30% of sentences
- **Images** — alt text with keyword (natural); descriptive filename; width/height set; lazy load below-fold; WebP <200KB
- **Internal links** — 2-3+ per page, descriptive anchors
- **External links** — 1-2 outbound to authoritative sources, `target="_blank" rel="noopener"`
- **Schema / JSON-LD** — 4+ per page minimum: Organization + WebSite + WebPage + domain-specific (FAQ, Product, BreadcrumbList, Article, HowTo, SoftwareApplication, DonateAction)
- **Technical** — canonical URL, mobile-friendly, LCP <2.5s, HTTPS, no duplicate content, XML sitemap, robots.txt
## Readability Enforcement (Flesch ≥60)
### Yoast 9 Checks (All Automatable)
- Flesch ≥60 | Sentence length avg ≤20 words | Paragraph length ≤150 words
- Passive voice <10% | Transition words ≥30% of sentences | Consecutive sentences <3 with same opening word
- Subheading distribution ≤300 words between H2/H3 | Text present | Exactly 1 H1
### By Section
Hero 80+ | Body 50-65 | Technical docs 40-50 | Legal 50+ | Errors 70+ | CTAs 80+
## Programmatic SEO
```typescript
// Dynamic pages: "Docker hosting in [city]"
const cities = ['New York', 'San Francisco', 'London'];
for (const city of cities) {
// slug, title, h1, metaDescription all include city + keyword
}
```
### Internal Linking Strategy
- Homepage → category pages → product pages | Blog → relevant products + related posts
- Every page: 2-3 internal links min; anchor text = keyphrase variations, never "click here"
- Orphan detection after build
## SEO Audit (Every Deploy)
Playwright test verifying: title 30-60 chars · meta desc 120-160 chars · exactly 1 H1 · canonical URL · OG tags · JSON-LD ≥1 · no Lorem/TODO/placeholder · images have alt · internal links ≥3 · `robots.txt` 200 · `sitemap.xml` 200
## API Stack ($8/mo total)
- **Google Search Console** — Free — real clicks/impressions
- **VebAPI** — $8/mo — competitor keywords, SERP
- **Serper free tier** — Free — 2,500/mo SERP + PAA
- **Google Suggest** — Free — keyword expansion
- **SearXNG (self-hosted)** — Free — PAA questions
- **DataForSEO** — $0.0006/query — bulk volumes at scale
## Google's SEO Rules (2026 Core Update)
- Original research/proprietary data rewarded (Information Gain signal)
- Write naturally, no stuffing
- LCP <2.5s is a hard ranking factor
- AI Overviews steal short-tail clicks — longtail more important than ever
- Meta keywords tag ignored
## Longtail Strategy (Moz 2026)
- Ultra-long-tail is "new normal"; short-tail triggers AI Overviews
- Modifier stacking: `[product] + [use case] + [audience] + [qualifier]`
- Problem-first keywords beat feature keywords
- GSC: impressions >10 but position >10 = low-hanging fruit
## MANDATORY: Research BEFORE Writing
1. Identify 5-10 candidate keyphrases
2. Evaluate — volume, difficulty, intent, relevance
3. Select PRIMARY (1-4 words, unique to page)
4. Select 2-3 RELATED keyphrases
5. Map keyword → page URL (no duplicates)
6. Write content optimized from first sentence
## Keyword-to-Page Map
```typescript
const keywordMap = {
'/': { primary: 'main keyword', related: ['variation 1', 'variation 2'] },
'/pricing': { primary: 'pricing keyword', related: [...] },
};
// No two pages share same primary keyphrase
```
## Rich Snippets
Every page — Organization + WebSite(SearchAction) + WebPage + domain-specific schema. OpenSearch XML at `/opensearch.xml`. Validate with Google Rich Results Test.
## Ownership
- **Owns:** keyword research, competitor analysis, per-page targeting, Yoast checks, readability, programmatic SEO, audit automation, internal linking, schema/JSON-LD, OG/Twitter tags, sitemap, robots.txt, keyword-to-page mapping
- **Never owns:** content writing (→09, 22), visual design (→10), deployment (→08)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |