majiayu000 Google SEO Best Practices
Description
This skill provides comprehensive guidance for optimizing web content and documentation for search engine discoverability based on Google's official SEO Starter Guide. Use this skill when creating new web content, reviewing existing pages for SEO compliance, or documenting best practices for web-based projects. The skill ensures content follows Google's people-first approach while implementing technical optimizations that improve search visibility.
When to Use This Skill
- When creating new web pages, documentation sites, or online content
- When reviewing existing web content for search optimization
- When generating HTML documentation that needs to be discoverable
- When implementing metadata (titles, descriptions, alt text) for web content
- When structuring URLs, navigation, or site architecture
- When providing guidance on content quality and organization
When NOT to Use This Skill
- For content not intended for search engines (internal tools, private documentation)
- For API-only services without web interfaces
- When SEO considerations conflict with user experience (prioritize UX)
- For content behind authentication walls where search indexing is inappropriate
Prerequisites
- Access to web content, documentation, or HTML files
- Understanding of basic HTML structure (
<title>,<meta>,<img>tags) - Familiarity with web architecture (URLs, directories, linking)
- Context about target audience and search vocabulary
Workflow
Phase 1: Content Discovery & Indexability
Purpose: Ensure Google can find and access your content
Step 1.1: Verify Indexing
Check if Google has already indexed your content:
# Use site: search operator in Google
site:example.com/your-page
Expected Output: Verification of whether page is indexed
Step 1.2: Enable Crawl Access
Ensure Google can access critical resources:
- CSS files are accessible (not blocked by robots.txt)
- JavaScript files are accessible
- Images are accessible
- Page renders properly in URL Inspection Tool
Decision Point:
- IF content is new → Submit sitemap (optional but helpful)
- IF content is established → Monitor via Search Console
- IF critical resources blocked → Update robots.txt
Expected Output: Confirmation that Googlebot can fully render page
Step 1.3: Establish Link Structure
Enable natural discovery through links:
- Ensure new pages are linked from existing indexed pages
- Create logical navigation hierarchy
- Implement breadcrumb navigation for deep content
Expected Output: Clear path for crawlers to discover content
Phase 2: URL Structure Optimization
Purpose: Create descriptive, organized URLs that enhance search results
Step 2.1: Design Descriptive URLs
Best Practices:
✅ Use meaningful words: example.com/pets/cats.html
❌ Avoid random IDs: example.com/2/6772756D707920636174
Implementation:
# Good URL structure
https://example.com/docs/api/authentication
https://example.com/products/laptops/gaming
# Poor URL structure
https://example.com/page?id=12345
https://example.com/p/a/b/c/xyz
Validation:
- URLs contain meaningful words
- URL segments reflect content hierarchy
- URLs are concise but descriptive
Step 2.2: Organize Directory Structure
Group similar content logically:
/policies/ # Infrequently updated content
/blog/ # Frequently updated content
/docs/getting-started/
/docs/api-reference/
/products/category/
Expected Output: Hierarchical URL structure that communicates update frequency and content grouping
Step 2.3: Manage Duplicate Content
Implement canonicalization:
<!-- In <head> of duplicate/alternate pages -->
<link rel="canonical" href="https://example.com/preferred-url" />
Or use 301 redirects:
# .htaccess example
Redirect 301 /old-page.html https://example.com/new-page.html
Expected Output: Each content piece accessible via one primary URL
Phase 3: Metadata Optimization
Purpose: Create compelling titles and descriptions that appear in search results
Step 3.1: Craft Unique Titles
Write clear, concise <title> elements:
<!-- Good examples -->
<title>API Authentication Guide | Example Docs</title>
<title>Gaming Laptops - High Performance | Example Store</title>
<!-- Poor examples -->
<title>Page 1</title>
<title>Home - Home - Home - Example</title>
<title>Buy cheap laptops gaming computers best deals discount sale</title>
Guidelines:
- Keep unique per page
- Include business name or key identifier
- Accurately describe page content
- Avoid keyword stuffing
Expected Output: Unique, descriptive titles for each page
Step 3.2: Write Meta Descriptions
Create 1-2 sentence summaries:
<!-- Good example -->
<meta name="description" content="Learn how to implement OAuth 2.0 authentication in our API with step-by-step code examples for Node.js, Python, and Ruby." />
<!-- Poor example -->
<meta name="description" content="API docs page authentication login security OAuth token password credential user access." />
Guidelines:
- One unique description per page
- Highlight most relevant information
- Keep succinct (1-2 sentences)
- Write naturally, not keyword-stuffed
Expected Output: Unique meta descriptions that accurately summarize page content
Phase 4: Image Optimization
Purpose: Make images discoverable and accessible
Step 4.1: Use High-Quality Images
Best Practices:
- Use sharp, clear images
- Place images near relevant text
- Ensure surrounding text explains image content
Step 4.2: Write Descriptive Alt Text
Implement proper alt attributes:
<!-- Good examples -->
<img src="golden-retriever-playing-fetch.jpg"
alt="Golden retriever catching red frisbee in park" />
<img src="api-authentication-flow.png"
alt="Diagram showing OAuth 2.0 authentication flow from client to server" />
<!-- Poor examples -->
<img src="img123.jpg" alt="image" />
<img src="photo.jpg" alt="" />
<img src="product.jpg" alt="buy now click here cheap discount sale" />
Guidelines:
- Keep short but descriptive
- Explain image-content relationship
- Avoid keyword stuffing
- Provide context for accessibility
Expected Output: All images have meaningful alt text
Phase 5: Content Quality & Link Strategy
Purpose: Create people-first content with proper link practices
Step 5.1: Ensure Content Quality
Core Attributes Checklist:
- Text is easy-to-read and well organized
- Content is unique (not copied from other sources)
- Information is current and updated
- Content is helpful, reliable, and people-first
- Expertise/authority is demonstrated
- No keyword stuffing (write naturally)
Organization:
- Break long content into paragraphs
- Use clear section headings
- Create logical navigation structure
Expected Output: High-quality, original, well-organized content
Step 5.2: Implement Link Best Practices
Anchor Text:
<!-- Good examples -->
<a href="/api/authentication">Learn about API authentication</a>
<a href="/products/gaming-laptops">Browse gaming laptops</a>
<!-- Poor examples -->
<a href="/page">click here</a>
<a href="/info">read more</a>
Outbound Links:
- Link to trusted resources that corroborate content
- Add
rel="nofollow"to untrusted sources
<!-- Trusted resource -->
<a href="https://oauth.net/2/">OAuth 2.0 specification</a>
<!-- User-generated or untrusted content -->
<a href="https://unknown-site.com" rel="nofollow">User submitted link</a>
Expected Output: Descriptive anchor text and properly qualified outbound links
Phase 6: Technical Implementation & Structured Data
Purpose: Implement technical SEO features
Step 6.1: Implement Structured Data
Add schema.org markup for rich results:
<!-- Breadcrumb example -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [{
"@type": "ListItem",
"position": 1,
"name": "Docs",
"item": "https://example.com/docs"
},{
"@type": "ListItem",
"position": 2,
"name": "API Reference",
"item": "https://example.com/docs/api"
}]
}
</script>
Step 6.2: Create and Submit Sitemap
Generate XML sitemap for content management:
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://example.com/docs/getting-started</loc>
<lastmod>2026-01-22</lastmod>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
</urlset>
Expected Output: Sitemap submitted to Search Console
Step 6.3: Configure Robots Meta Tags
Control crawl/index behavior when needed:
<!-- Prevent indexing of test pages -->
<meta name="robots" content="noindex, nofollow" />
<!-- Allow indexing, prevent link following -->
<meta name="robots" content="index, nofollow" />
Expected Output: Appropriate robots directives on all pages
Examples
Example 1: Optimizing Documentation Site
Context: Creating new API documentation site with 50+ pages
Input:
Project: API Documentation
Pages: Authentication, Endpoints, Examples, Guides
Current state: Basic HTML with generic titles
Execution Flow:
- Phase 1: Verify localhost isn't blocking CSS/JS → Create sitemap
- Phase 2: Restructure URLs from
/page1.htmlto/docs/authentication - Phase 3: Write unique titles:
<title>API Authentication - OAuth 2.0 Guide | Example API</title><title>POST /users Endpoint Reference | Example API</title>
- Phase 4: Add alt text to all code diagram images
- Phase 5: Add descriptive anchor text to cross-references
- Phase 6: Implement breadcrumb structured data
Expected Output:
- 50 pages with unique, descriptive titles and meta descriptions
- Logical URL hierarchy (
/docs/authentication,/docs/endpoints/users) - All images with proper alt text
- Breadcrumb navigation with schema.org markup
- Sitemap submitted to Search Console
Rationale: Documentation sites benefit greatly from SEO as users primarily discover APIs through search
Example 2: Content Quality Review
Context: Existing blog with poor search performance
Input:
Current issues:
- Generic titles ("Blog Post 1", "Blog Post 2")
- No meta descriptions
- Short, thin content (<200 words)
- Heavy keyword stuffing
- No internal linking structure
Execution Flow:
- Quality Audit: Identify thin content for expansion or deletion
- Title Rewrite: "Blog Post 1" → "How to Implement OAuth 2.0 in Node.js"
- Meta Description: Add unique 1-2 sentence summary per post
- Content Enhancement: Expand thin posts with unique insights
- Link Structure: Add descriptive internal links between related posts
- Keyword Review: Remove keyword stuffing, write naturally
Expected Output:
<!-- Before -->
<title>Blog Post 1</title>
<!-- No meta description -->
<p>OAuth security authentication login API security token...</p>
<!-- After -->
<title>How to Implement OAuth 2.0 in Node.js | Example Blog</title>
<meta name="description" content="Learn how to add OAuth 2.0 authentication to your Node.js application with this step-by-step tutorial including code examples." />
<p>OAuth 2.0 provides a secure authentication framework for web applications. This guide walks through implementing OAuth in a Node.js Express application...</p>
Rationale: Demonstrates transformation from SEO anti-patterns to best practices
Example 3: E-commerce Product Pages
Context: 500 product pages with duplicate content issues
Input:
Problem: Multiple URLs for same product
- example.com/products/laptop-123
- example.com/products/laptop-123?color=black
- example.com/products/laptop-123?utm_source=email
All have identical content, causing duplicate content issues
Execution Flow:
- Canonicalization: Add canonical link to all variants
<link rel="canonical" href="https://example.com/products/laptop-123" /> - Image Optimization: Add product-specific alt text
<img src="laptop.jpg" alt="15-inch gaming laptop with RGB keyboard and GeForce RTX 4080" /> - Unique Descriptions: Write unique meta description per product
- Structured Data: Add Product schema for rich results
{ "@type": "Product", "name": "Gaming Laptop XZ-500", "description": "High-performance 15-inch gaming laptop", "offers": { "@type": "Offer", "price": "1299.99", "priceCurrency": "USD" } }
Expected Output:
- All product variants canonicalize to primary URL
- Each product has unique, descriptive title and meta description
- Product images have descriptive alt text (not just "product image")
- Structured data enables rich search results (price, reviews, availability)
Rationale: E-commerce sites particularly benefit from structured data and canonical URLs
Quality Standards
Output Requirements
- All pages must have unique
<title>elements (100% compliance) - All images must have descriptive
altattributes (100% compliance) - URLs must contain meaningful words, not random IDs (100% compliance)
- Meta descriptions should be present on priority pages (90%+ coverage)
- No keyword stuffing in any content (zero tolerance)
Performance Requirements
- Content quality audit: Complete within 2-3 hours for 50-page sites
- Metadata generation: <2 minutes per page
- Sitemap generation: <5 minutes for 1000-page sites
Integration Requirements
- Works with static site generators (Jekyll, Hugo, Gatsby)
- Compatible with CMS platforms (WordPress, Drupal, custom systems)
- Integrates with Search Console API for automated monitoring
Common Pitfalls
Pitfall 1: Keyword Stuffing
Issue: Repeating keywords unnaturally to manipulate rankings Why it happens: Misunderstanding of how modern search algorithms work Solution:
- Write naturally for humans, not search engines
- Google's systems automatically handle keyword variations
- Keyword stuffing violates spam policies and harms rankings
- Focus on comprehensive, helpful content instead
Pitfall 2: Duplicate Titles Across Pages
Issue: Using same title on multiple pages (e.g., "Welcome to Example.com") Why it happens: Copy-paste during development, template issues Solution:
# Audit for duplicate titles
grep -r "<title>" . | sort | uniq -d
# Each page needs unique title reflecting its specific content
# Bad: All pages use "<title>Example Docs</title>"
# Good: Each page has specific title like "Authentication | Example Docs"
Pitfall 3: Missing or Generic Alt Text
Issue: Images without alt text or generic placeholders ("image", "photo") Why it happens: Alt text seen as optional, not understanding its importance Solution:
- Alt text improves accessibility (screen readers)
- Helps Google understand image context
- Contributes to image search rankings
- Write short, descriptive alt text for every meaningful image
- Decorative images can use empty alt (
alt="") but content images need description
Pitfall 4: Blocking CSS/JS from Crawlers
Issue: robots.txt blocks stylesheets or JavaScript, preventing proper page rendering Why it happens: Overcautious robots.txt configuration Solution:
# Bad - blocks critical rendering resources
User-agent: *
Disallow: /css/
Disallow: /js/
# Good - allows CSS/JS, blocks actual private content
User-agent: *
Disallow: /admin/
Disallow: /private/
Allow: /css/
Allow: /js/
Pitfall 5: Neglecting Mobile Experience
Issue: Poor mobile rendering affects rankings (mobile-first indexing) Why it happens: Desktop-only testing, responsive design issues Solution:
- Test with Mobile-Friendly Test tool
- Use responsive design
- Avoid intrusive interstitials on mobile
- Ensure text is readable without zooming
Integration with Command & Control
Related Agents
- Scribe Agent: Collaborates on documentation generation, applying SEO best practices to all generated content
- Builder Agent: Consults during web application development to ensure SEO-friendly architecture from start
- Validator Agent: Reviews HTML output for SEO compliance before deployment
Related Commands
/docs: Use SEO skill when generating documentation to ensure search discoverability/prepare-pr: Include SEO validation in pre-merge checklist for web content changes/create-skill: Reference as example of comprehensive skill documentation
MCP Dependencies
None required for basic functionality. Optional integrations:
- Search Console MCP: Programmatic access to indexing status and search analytics
- Sitemap Generator MCP: Automated sitemap creation and submission
Orchestration Notes
- Chained with: documentation-skill, content-writing-skill, accessibility-skill
- Invoked by: scribe-agent, builder-agent
- Invokes: None (leaf skill)
Troubleshooting
Issue: Pages Not Appearing in Search Results
Symptoms: Content exists but doesn't show in site: search
Diagnosis:
- Check robots.txt isn't blocking crawlers
- Verify robots meta tags aren't set to
noindex - Check if page is linked from other indexed pages
- Use URL Inspection Tool in Search Console Solution:
- Ensure robots.txt allows crawling:
Allow: / - Remove/fix
noindexdirectives if inappropriate - Create internal links from homepage or sitemap
- Submit URL via Search Console for expedited indexing
Issue: Title/Description Not Matching What Appears in Search
Symptoms: Google shows different title or description than your HTML Diagnosis: Google may override titles/descriptions deemed unhelpful Solution:
- Review title for keyword stuffing or manipulation
- Ensure title accurately describes page content
- Make titles unique and concise (under 60 characters)
- Write descriptive meta descriptions (under 160 characters)
- Google uses page content for snippets when meta description is missing/poor
Issue: Duplicate Content Warnings
Symptoms: Search Console reports duplicate content issues Diagnosis: Same content accessible via multiple URLs Solution:
<!-- Add canonical link to all duplicate versions -->
<link rel="canonical" href="https://example.com/preferred-url" />
<!-- Or implement 301 redirects -->
- Choose one canonical URL per content piece
- Use rel="canonical" on all variants
- Consider parameter handling in Search Console
- Implement 301 redirects when possible
Issue: Images Not Appearing in Image Search
Symptoms: Images exist but don't show in Google Image Search Diagnosis: Missing alt text, poor image quality, or blocked images Solution:
- Add descriptive alt text to all images
- Use high-quality, sharp images (not blurry/pixelated)
- Place images near relevant text
- Ensure robots.txt doesn't block image files
- Submit image sitemap for large image collections
Debunked SEO Myths
The following practices are ineffective or harmful:
❌ Keyword Meta Tags
<meta name="keywords">is ignored by Google- Has no ranking influence
- Remove or don't bother adding
❌ Domain Keywords
- Having keywords in domain name has minimal impact
- Content quality matters far more
- Don't rebrand for keyword-rich domain
❌ Content Length Alone
- Long content doesn't automatically rank higher
- Quality and usefulness matter more than word count
- Short, comprehensive content can outrank long, thin content
❌ Exact Match Keywords
- Google handles synonyms and variations automatically
- Writing naturally is better than forcing exact phrases
- Keyword stemming and semantic understanding are sophisticated
✅ Focus Instead On:
- People-first content
- Natural, helpful writing
- Technical best practices (this skill)
- User experience
- Expertise and authority
Version History
- 1.0.0 (2026-01-22): Initial release
- Comprehensive SEO guidance from Google's official starter guide
- URL structure, metadata, content quality workflows
- Image optimization and link best practices
- Technical implementation examples
- Common pitfalls and troubleshooting
- Integration with Command & Control system