GO

google-official-seo-guide

Assists with technical SEO, schema markup, crawl issue resolution, and mobile-first performance monitoring.

Install

mkdir -p .claude/skills/google-official-seo-guide && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/225" && unzip -o skill.zip -d .claude/skills/google-official-seo-guide && rm skill.zip

Installs to .claude/skills/google-official-seo-guide

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Official Google SEO guide covering search optimization, best practices, Search Console, crawling, indexing, and improving website search visibility based on official Google documentation
186 charsno explicit “when” trigger
Beginner

Key capabilities

  • Map content to schema.org markup structures
  • Verify robots.txt and sitemap compliance
  • Debug crawl error logs from Search Console
  • Identify mobile-first indexing issues
  • Configure canonical tag hierarchies

How it works

References official Google documentation standards to provide actionable configuration steps for crawling, indexing, and rendering optimization.

Inputs & outputs

You give it
URL, content type, or technical SEO issue description
You get back
Implementation instructions, schema code, or diagnostic steps

When to use google-official-seo-guide

  • Implement VideoObject structured data
  • Troubleshoot crawl errors in Search Console
  • Configure canonical tags for duplicate content
  • Optimize internal linking structure

About this skill

Google Official SEO Guide

Comprehensive assistance with Google Search optimization, SEO best practices, and search visibility improvements based on official Google documentation.

When to Use This Skill

This skill should be triggered when users ask about:

SEO & Search Optimization

  • Improving website ranking in Google Search
  • Implementing SEO best practices
  • Optimizing meta tags, titles, and descriptions
  • Fixing crawling or indexing issues
  • Understanding how Google Search works

Structured Data & Rich Results

  • Adding VideoObject, BroadcastEvent, or Clip structured data
  • Implementing schema.org markup for rich results
  • Creating sitemaps and robots.txt files
  • Setting up breadcrumb navigation
  • Configuring hreflang for multi-language sites

Technical SEO

  • Mobile-first indexing optimization
  • JavaScript SEO and rendering issues
  • Managing duplicate content with canonical tags
  • Configuring robots meta tags
  • URL structure and internal linking

Search Console & Monitoring

  • Using Google Search Console reports
  • Debugging search visibility issues
  • Monitoring crawl errors and indexing status
  • Analyzing search performance metrics

Content & Links

  • Writing effective anchor text
  • Internal and external linking strategies
  • Avoiding spam policies violations
  • Managing site migrations and redirects

Key Concepts

The Three Stages of Google Search

  1. Crawling: Googlebot discovers and fetches pages from the web
  2. Indexing: Google analyzes page content and stores it in the index
  3. Serving: Google returns relevant results for user queries

Important SEO Principles

  • Mobile-First Indexing: Google primarily uses the mobile version of content for indexing and ranking
  • Canonical URLs: Specify the preferred version of duplicate or similar pages
  • Structured Data: Use schema.org markup to help Google understand your content
  • Search Essentials: Technical, content, and spam requirements for Google Search eligibility

Common Structured Data Types

  • VideoObject: For video content and features
  • BroadcastEvent: For livestream videos (LIVE badge)
  • Clip: For video key moments/timestamps
  • SeekToAction: For auto-detected key moments in videos

Quick Reference

Example 1: Basic VideoObject Structured Data

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "Video title",
  "description": "Video description",
  "thumbnailUrl": [
    "https://example.com/photos/1x1/photo.jpg",
    "https://example.com/photos/4x3/photo.jpg",
    "https://example.com/photos/16x9/photo.jpg"
  ],
  "uploadDate": "2024-03-31T08:00:00+08:00",
  "duration": "PT1M54S",
  "contentUrl": "https://example.com/video.mp4",
  "embedUrl": "https://example.com/embed/123"
}

Use this for: Adding basic video metadata to help Google understand and display your videos in search results.


Example 2: LIVE Badge with BroadcastEvent

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "Livestream title",
  "uploadDate": "2024-10-27T14:00:00+00:00",
  "publication": {
    "@type": "BroadcastEvent",
    "isLiveBroadcast": true,
    "startDate": "2024-10-27T14:00:00+00:00",
    "endDate": "2024-10-27T14:37:14+00:00"
  }
}

Use this for: Enabling the LIVE badge on livestream videos in Google Search results.


Example 3: Video Key Moments with Clip

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "Cat video",
  "hasPart": [
    {
      "@type": "Clip",
      "name": "Cat jumps",
      "startOffset": 30,
      "endOffset": 45,
      "url": "https://example.com/video?t=30"
    },
    {
      "@type": "Clip",
      "name": "Cat misses the fence",
      "startOffset": 111,
      "endOffset": 150,
      "url": "https://example.com/video?t=111"
    }
  ]
}

Use this for: Manually specifying important timestamps/chapters in your video for the key moments feature.


Example 4: Good Anchor Text Practices

<!-- Bad: Too generic -->
<a href="https://example.com">Click here</a> to learn more.

<!-- Better: Descriptive and contextual -->
For a full list of cheese available for purchase, see the
<a href="https://example.com">list of cheese types</a>.

<!-- Bad: Too many adjacent links -->
I've written about cheese
<a href="/page1">so</a>
<a href="/page2">many</a>
<a href="/page3">times</a>.

<!-- Better: Spaced out with context -->
I've written about cheese so many times this year:
the <a href="/blue-cheese">controversy over blue cheese</a>,
the <a href="/oldest-brie">world's oldest brie</a>, and
<a href="/boy-and-cheese">A Boy and His Cheese</a>.

Use this for: Creating effective internal and external links that help both users and Google understand your content.


Example 5: Crawlable Links

<!-- Recommended: Google can crawl these -->
<a href="https://example.com">Link text</a>
<a href="/products/category/shoes">Link text</a>
<a href="./products/category/shoes">Link text</a>

<!-- Not recommended: May not be crawled -->
<a routerLink="products/category">Link text</a>
<a onclick="goto('https://example.com')">Link text</a>
<span href="https://example.com">Link text</span>

Use this for: Ensuring your links are discoverable and crawlable by Googlebot.


Example 6: Mobile and Desktop hreflang for Separate URLs

<!-- Mobile version (https://m.example.com/) -->
<link rel="canonical" href="https://example.com/">
<link rel="alternate" hreflang="es" href="https://m.example.com/es/">
<link rel="alternate" hreflang="fr" href="https://m.example.com/fr/">

<!-- Desktop version (https://example.com/) -->
<link rel="canonical" href="https://example.com/">
<link rel="alternate" media="only screen and (max-width: 640px)"
      href="https://m.example.com/">
<link rel="alternate" hreflang="es" href="https://example.com/es/">
<link rel="alternate" hreflang="fr" href="https://example.com/fr/">

Use this for: Properly configuring separate mobile URLs (m-dot sites) with internationalization support.


Example 7: robots meta tags

<!-- Don't index this page -->
<meta name="robots" content="noindex">

<!-- Don't follow links on this page -->
<meta name="robots" content="nofollow">

<!-- Don't index and don't follow -->
<meta name="robots" content="noindex, nofollow">

<!-- Don't show snippet in search results -->
<meta name="robots" content="nosnippet">

Use this for: Controlling how Google crawls and indexes specific pages.


Example 8: InteractionStatistic for Video Views

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "Video title",
  "interactionStatistic": {
    "@type": "InteractionCounter",
    "interactionType": { "@type": "WatchAction" },
    "userInteractionCount": 12345
  }
}

Use this for: Displaying the number of views/watches for your video content.


Example 9: External Links with Attribution

<!-- Citing sources with proper attribution -->
<p>
According to a recent study from Swiss researchers,
Emmental cheese wheels exposed to music had a milder flavor,
with the full findings available in
<a href="https://example.com/cheese-study">
  Cheese in Surround Sound—a culinary art experiment
</a>.
</p>

<!-- Use nofollow when you don't trust the source -->
<a href="https://untrusted-site.com" rel="nofollow">
  Untrusted content
</a>

<!-- Sponsored links must be marked -->
<a href="https://partner-site.com" rel="sponsored">
  Partner content
</a>

Use this for: Properly linking to external sources while maintaining SEO best practices.


Example 10: Mobile-First Indexing Checklist

<!-- Ensure same robots meta tags on mobile and desktop -->
<meta name="robots" content="index, follow">

<!-- Use same structured data on both versions -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Example Corp"
}
</script>

<!-- Ensure images have proper alt text on mobile -->
<img src="product.jpg" alt="Blue ceramic vase, 12 inches tall">

<!-- Use same title and meta description -->
<title>Product Name - Category | Site Name</title>
<meta name="description" content="High-quality product description">

Use this for: Ensuring your mobile site is properly optimized for Google's mobile-first indexing.

Reference Files

This skill includes comprehensive documentation organized into the following categories:

apis.md (1 page)

Content: Getting started with Google Search Console, monitoring tools, and APIs.

Key Topics:

  • Setting up Search Console
  • Reports for SEO specialists and marketers
  • Reports for web developers
  • Managing site performance

When to use: Setting up monitoring, accessing Search Console features, understanding available reports.


appearance.md (58 pages)

Content: Visual elements and rich results in Google Search.

Key Topics:

  • Visual Elements Gallery (text results, rich results, images, videos)
  • Attribution elements (favicon, site name, breadcrumbs)
  • Structured data features
  • Search result optimization
  • Title links and snippets

When to use: Optimizing how your content appears in search results, implementing rich results, understanding search UI elements.


crawling.md

Content: How Google discovers, crawls, and accesses web content.

Key Topics:

  • Googlebot behavior and user agents
  • Crawl budget and optimization
  • robots.txt configuration
  • Managing crawl rate
  • Handling special file types

When to use: Debugging crawling issues, optimizing crawl efficiency, controlling what Google crawls.


fundamentals.md

Content: Core concepts and essential SEO knowledge.

Key Topics:

  • How Google Search works (crawling, indexing, serving)
  • SEO starter guide
  • Search Essentials
  • Creating helpful content
  • Site organization and URL structure

**When


Content truncated.

When not to use it

  • Black-hat SEO strategy implementation
  • Non-Google search engine specific tuning

Limitations

  • Guidance reflects current documentation; search algorithms evolve frequently
  • Cannot physically access private Search Console accounts
  • Results depend on accurate user-provided site context

How it compares

It strictly follows official Google documentation, filtering out outdated or unreliable SEO tactics.

Compared to similar skills

google-official-seo-guide side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
google-official-seo-guide (this skill)1439moNo flagsBeginner
nextjs-developer3282moNo flagsAdvanced
google-analytics436moReviewIntermediate
core-web-vitals406moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

nextjs-developer

zenobi-us

Expert Next.js developer mastering Next.js 14+ with App Router and full-stack features. Specializes in server components, server actions, performance optimization, and production deployment with focus on building fast, SEO-friendly applications.

328531

google-analytics

davila7

Analyze Google Analytics data, review website performance metrics, identify traffic patterns, and suggest data-driven improvements. Use when the user asks about analytics, website metrics, traffic analysis, conversion rates, user behavior, or performance optimization.

43193

core-web-vitals

davila7

Optimize Core Web Vitals (LCP, INP, CLS) for better page experience and search ranking. Use when asked to "improve Core Web Vitals", "fix LCP", "reduce CLS", "optimize INP", "page experience optimization", or "fix layout shifts".

40187

web-performance-optimization

davila7

Optimize website and web application performance including loading speed, Core Web Vitals, bundle size, caching strategies, and runtime performance

1048

web-quality-audit

davila7

Comprehensive web quality audit covering performance, accessibility, SEO, and best practices. Use when asked to "audit my site", "review web quality", "run lighthouse audit", "check page quality", or "optimize my website".

732

roier-seo

davila7

Technical SEO auditor and fixer. Runs Lighthouse/PageSpeed audits on websites or local dev servers, analyzes SEO/performance/accessibility scores, and automatically implements fixes for meta tags, structured data, Core Web Vitals, and accessibility issues.

424

Search skills

Search the agent skills registry