indranilbanerjee/digital-marketing-pro / skills/context-engine
context-engine
VerifiedLoad shared marketing context: brand profile, benchmarks, compliance rules, specs. "load my brand context"
google-seo-reference.md
View on GitHub# Google SEO Quick Reference (July 2026)
Concise reference guide for agents and skills. Not a reproduction of Google's documentation — see Official Documentation Links at the bottom for full details. Volatile items (surfaces, schema status, algorithm dates) carry a date — re-verify anything older than ~3 months against the official docs and the [Search Status Dashboard](https://status.search.google.com/).
---
## How Google Search Works
Three stages: **Crawling** (Googlebot discovers pages via links and sitemaps), **Indexing** (processes and stores content, metadata, signals), **Serving** (ranks indexed pages by relevance, quality, usability). Pages must be crawlable and indexable to appear.
---
## Google Search Essentials
### Technical Requirements
- Pages accessible to Googlebot (not blocked by robots.txt or noindex)
- HTTP 200 for indexable content
- HTML preferred; JS-rendered content supported but slower to index
- HTTPS required
### Spam Policies
- No cloaking, doorway pages, hidden text/links
- No keyword stuffing, link spam (buying links, excessive exchanges)
- No scraped or auto-generated content without added value
- No sneaky redirects, thin affiliate pages
- **Scaled Content Abuse** (March 2024): many pages made mainly to rank, "no matter how it's created" (spam policies, updated 2026-08-28)
- **Site Reputation Abuse** (November 2024): Third-party content on high-authority domains without editorial oversight
### Key Best Practices
- Content for users, not search engines
- Clear hierarchy, descriptive unique titles and meta descriptions
- Heading tags (H1-H6) for logical structure
- Image alt text and appropriate file sizes
- Mobile-friendly responsive design
- Core Web Vitals optimization
- XML sitemap in Search Console
- JSON-LD structured data
---
## E-E-A-T (Content Quality)
- **Experience**: First-hand experience (original photos, personal stories, demonstrated use)
- **Expertise**: Relevant knowledge or credentials (professional background, technical depth)
- **Authoritativeness**: Recognized as a go-to source (citations, brand mentions, expert recognition)
- **Trustworthiness**: Reliable and transparent (contact info, secure site, editorial standards)
**YMYL**: Health, finance, safety, legal topics held to highest E-E-A-T standards.
**Updates since late 2025**: Google's Search Status Dashboard (status.search.google.com, read 2026-10-27) lists the December 2025 core update (11-29 Dec), the March 2026 spam (24-25 Mar) and core (27 Mar-8 Apr) updates, the May 2026 core update (21 May-1 Jun), spam updates in June, August and September 2026, and the August 2025 spam update (26 Aug-21 Sep), none with a description of what changed. Google published no statement that any of them changed how E-E-A-T applies.
---
## Core Web Vitals
Measured at the 75th percentile of real user data (field data).
| Metric | Good | Needs Improvement | Poor |
|--------|------|-------------------|------|
| **LCP** (Largest Contentful Paint) | ≤ 2.5s | 2.5s – 4.0s | > 4.0s |
| **INP** (Interaction to Next Paint) | ≤ 200ms | 200ms – 500ms | > 500ms |
| **CLS** (Cumulative Layout Shift) | ≤ 0.1 | 0.1 – 0.25 | > 0.25 |
- INP replaced FID on March 12, 2024. FID fully removed from all Chrome tools September 9, 2024. Do NOT reference FID.
- CWV are a confirmed ranking signal (since June 2021)
- Field data (CrUX) preferred over lab data (Lighthouse)
---
## Schema Markup Status (July 2026)
### Active and Supported
Article, BreadcrumbList, Course, Dataset, Event, ItemList, JobPosting, LocalBusiness, Organization, Person, Product, ProductGroup, ProfilePage, Recipe, Review, SoftwareApplication, SoftwareSourceCode, VideoObject, Clip, SeekToAction, BroadcastEvent, Certification, OfferShippingDetails, MerchantReturnPolicy, DiscussionForumPosting
### Deprecated / Restricted
- **HowTo**: Deprecated (Sept 2023) — rich results removed
- **FAQ**: Restricted to gov/health sites only (Aug 2023)
- **SpecialAnnouncement**: Deprecated (July 2025)
- **EnergyConsumptionDetails**: Replaced by Certification (April 2025)
### JSON-LD Required
Google recommends JSON-LD for all structured data. Microdata and RDFa are supported but not preferred.
---
## Image SEO Best Practices
- **Format**: WebP or AVIF (both supported by every current major browser; check caniuse.com for a given audience) over JPEG/PNG
- **`<picture>`**: Progressive enhancement with AVIF > WebP > JPEG fallback
- **LCP image**: `fetchpriority="high"`, NO `loading="lazy"`, NO `decoding="async"`
- **Non-LCP images**: `loading="lazy"` + `decoding="async"`
- **Dimensions**: Always set `width` and `height` on `<img>` for CLS prevention
- **Alt text**: Descriptive (10-125 chars), natural keyword inclusion, not "image.jpg"
- **File names**: Descriptive, hyphenated, lowercase (`blue-running-shoes.webp`)
- **JPEG XL**: Chrome support being restored (Nov 2025 announcement) — not yet in stable. Monitor.
---
## AI Search Optimization (GEO/AEO)
### Canonical surfaces (6, mid-2026)
The plugin scores AI visibility across six surfaces (the `PLATFORMS` constant in `scripts/geo-tracker.py`; scored with the rubric in `/digital-marketing-pro:aeo-audit`):
- **Google AI Mode** — conversational search tab; 1B+ monthly users and Gemini 3.5 Flash as its default model; AI Overviews stay the default surface (see the AI Mode note in `skills/aeo-geo/SKILL.md`). **Distinct from AI Overviews** — different citation pattern for the same query; audit it separately.
- **Google AI Overviews** — summary block above classic SERP results
- ChatGPT (web search mode)
- Perplexity
- Gemini
- Microsoft Copilot
### What's new since March 2026
- **GSC AI Performance Report (3 Jun 2026, UK-first then global):** actual impressions in AI Overviews + AI Mode for verified properties, plus a property-level **AI opt-out toggle** (no AI-specific robots directive needed). Excludes click data. See `/digital-marketing-pro:gsc-ai-performance`.
- **GA4 `AI Assistant` channel group (13 May 2026):** captures `Medium=ai-assistant` referrals from ChatGPT / Gemini / Claude — the click-side complement to the GSC report.
- **Official Google position (AI features guide, last updated 2026-07-10):** no `llms.txt`, no AI-specific schema, no separate AI eligibility gate — pages eligible for snippets in classic Search are eligible for AI features.
- **`Google-Extended`** (robots.txt) still controls Google's *other* AI systems (Gemini training, Vertex grounding), distinct from the in-Search-Console AI Overviews/AI Mode toggle.
### Optimization Signals
- **Entity consistency**: Brand name, descriptions, key claims consistent across website, social profiles, directories, third-party mentions
- **Citation-worthy content**: Stats, original research, expert quotes, structured data
- **Structured answers**: Concise answer blocks suitable for featured snippets and AI extraction
- **Speakable content**: Short, clear answers for voice search and AI assistants
- **Source authority**: Established domain authority, quality backlinks, E-E-A-T signals
---
## Official Documentation Links
- Google Search Central: https://developers.google.com/search
- Search Console Help: https://support.google.com/webmasters
- Structured Data: https://developers.google.com/search/docs/appearance/structured-data
- Core Web Vitals: https://web.dev/vitals/
- Search Quality Rater Guidelines: https://guidelines.raterhub.com/
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |