SEO Fundamentals System

A Claude Code skill covering the foundational principles of search engine optimization. Designed for developers, marketers, and content creators who need to understand and implement core SEO best practices without the complexity of enterprise-level tools.

When to Use This Skill

Choose SEO Fundamentals when:

• You're new to SEO and need to understand the core principles
• You want a quick checklist for optimizing a page or blog post
• You need to implement basic on-page SEO for a new website
• You want to understand E-E-A-T and how Google evaluates content quality
• You need fundamental technical SEO guidance for a small to medium site

Consider alternatives when:

• You need advanced technical SEO for large sites (use an advanced SEO skill)
• You want programmatic page generation at scale (use a programmatic SEO skill)
• You need schema markup implementation (use a schema markup skill)

Quick Start

Copy
# Install the skill
claude install seo-fundamentals-system

# Optimize a blog post
claude "Optimize this blog post for the keyword 'best project management tools 2026': [paste content]"

# Get an on-page SEO checklist
claude "Give me an on-page SEO checklist for our new SaaS landing page"

# Understand E-E-A-T
claude "How do I improve E-E-A-T signals for our company blog about developer tools?"

Core Concepts

E-E-A-T Framework

Principle	What Google Looks For	How to Demonstrate
Experience	First-hand knowledge and real usage	Share personal experiences, screenshots, original data
Expertise	Deep knowledge of the subject	Author bios, credentials, depth of content
Authoritativeness	Recognition from others in the field	Backlinks, mentions, citations from reputable sources
Trustworthiness	Accuracy, transparency, safety	HTTPS, clear contact info, accurate claims, proper sourcing

On-Page SEO Essentials

Title Tag:
  → Include primary keyword near the beginning
  → Keep under 60 characters
  → Make it compelling to click (not just keyword-stuffed)

Meta Description:
  → Summarize the page's value proposition
  → Keep under 155 characters
  → Include a call to action

Headings:
  → One H1 per page (primary keyword included)
  → H2s for major sections (secondary keywords)
  → H3s for subsections (related terms)

Content:
  → Answer the user's query thoroughly
  → Use natural language (no keyword stuffing)
  → Include related terms and synonyms
  → Add internal links to relevant pages

Technical SEO Basics

Element	Implementation	Impact
HTTPS	SSL certificate on all pages	Trust signal, ranking factor
Mobile-Friendly	Responsive design, mobile viewport	Core ranking factor
Page Speed	Optimize images, minimize JS/CSS, use CDN	Core Web Vital
Sitemap	XML sitemap submitted to Search Console	Crawl efficiency
Robots.txt	Allow important pages, block admin/duplicates	Crawl control
Canonical Tags	Self-referencing canonical on all pages	Prevent duplication

Configuration

Parameter	Type	Default	Description
experience_level	string	"beginner"	Level: beginner, intermediate
site_type	string	"blog"	Type: blog, saas, ecommerce, portfolio
framework	string	"nextjs"	Tech framework for specific implementation guidance
focus	string	"on_page"	Focus: on_page, technical, content, all

Best Practices

1. Write for users first, search engines second — Google's algorithms are designed to reward content that genuinely helps users. If your content answers the user's question better than any other result, rankings will follow.

2. One primary keyword per page — Each page should target one primary keyword and its natural variations. Don't try to rank one page for unrelated keywords; create separate pages for separate topics.

3. Internal linking is free and powerful — Link related pages together using descriptive anchor text. This helps Google understand your site structure and distributes authority across your pages. Most sites under-utilize internal links.

4. Update content regularly — Google favors fresh content, especially for topics that change over time. Update your best-performing posts with new data, examples, and information at least annually.

5. Measure what matters — Track organic traffic, keyword rankings, and click-through rates in Google Search Console. Don't obsess over domain authority scores from third-party tools; focus on actual search performance.

Common Issues

New site not appearing in Google — Submit your sitemap to Google Search Console, ensure your pages aren't marked noindex, and build a few quality backlinks. New sites can take 2-4 weeks to start appearing in results.

Rankings for wrong keywords — Your content might not match the intent of your target keyword. Search for the keyword yourself and compare the top results to your page. Adjust your content to match the format and depth of what's ranking.

Traffic but no conversions from SEO — You may be ranking for informational keywords while your page is transactional. Match the content type to the user's intent, and add clear CTAs that align with where the user is in their journey.