Agent skill

faion-seo-skill

Comprehensive SEO and AEO (Answer Engine Optimization) skill. Technical SEO, multilingual hreflang, schema markup, llms.txt, Core Web Vitals, accessibility, social meta tags. Use for SEO audits, optimization, and AI search visibility.

View SKILL.md on GitHub Repository

Stars 163

Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/faion-seo-skill

SKILL.md

SEO & AEO Mastery

Modern SEO for Search Engines AND AI Assistants (2025-2026)

Quick Reference

Area	Key Elements
Technical	robots.txt, sitemap.xml, crawl budget, Core Web Vitals
On-Page	Semantic HTML, schema markup, headings, meta tags
Multilingual	hreflang, URL structure, x-default
AI/AEO	llms.txt, structured data, entity optimization
Social	Open Graph, Twitter Cards, LinkedIn
Accessibility	WCAG 2.2, ARIA, screen readers, semantic markup
Performance	LCP < 2.5s, INP < 200ms, CLS < 0.1

Core Principles

1. Dual Optimization Strategy

Traditional SEO (Google, Bing)
        ↓
    Your Content
        ↓
AI Search (ChatGPT, Perplexity, Claude)

Both need: Clear structure, authoritative content, proper markup, fast loading.

2. E-E-A-T Framework

Experience → First-hand knowledge, case studies
Expertise → Author credentials, depth of content
Authoritativeness → Backlinks, citations, brand mentions
Trustworthiness → HTTPS, contact info, privacy policy

Technical SEO Fundamentals

robots.txt Best Practices

txt

# robots.txt - faion.net

User-agent: *
Disallow: /admin/
Disallow: /api/internal/
Disallow: /*?sessionid=
Disallow: /*?utm_
Allow: /api/public/

# AI Crawlers (manage separately)
User-agent: GPTBot
Disallow: /premium/
Allow: /

User-agent: Claude-Web
Disallow: /premium/
Allow: /

User-agent: PerplexityBot
Allow: /

# Sitemaps
Sitemap: https://faion.net/sitemap.xml
Sitemap: https://faion.net/sitemap-articles.xml

Key Rules:

Block admin, session URLs, internal APIs
Manage AI crawlers separately from search crawlers
Always include Sitemap directive
Never block CSS/JS files
Test in Google Search Console before deploying

sitemap.xml Structure

xml

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
        xmlns:xhtml="http://www.w3.org/1999/xhtml">
  <url>
    <loc>https://faion.net/guides/sdd-methodology/</loc>
    <lastmod>2026-01-18</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.8</priority>
    <!-- Multilingual alternates -->
    <xhtml:link rel="alternate" hreflang="en" href="https://faion.net/en/guides/sdd-methodology/" />
    <xhtml:link rel="alternate" hreflang="uk" href="https://faion.net/uk/guides/sdd-methodology/" />
    <xhtml:link rel="alternate" hreflang="x-default" href="https://faion.net/guides/sdd-methodology/" />
  </url>
</urlset>

Best Practices:

Max 50,000 URLs per sitemap (use sitemap index for more)
Update lastmod only when content changes
Include in sitemap ONLY indexable pages
Don't include URLs blocked in robots.txt

Multilingual SEO & hreflang

URL Structure Options

Pattern	Example	Pros	Cons
Subdirectories (recommended)	`/uk/`, `/en/`	Easy to manage, shared domain authority	None significant
Subdomains	`uk.faion.net`	Separate hosting possible	Split domain authority
ccTLDs	`faion.ua`	Strong geo-signal	Expensive, complex management
Parameters ❌	`?lang=uk`	Easy to implement	Poor SEO, indexing issues

hreflang Implementation

html

<head>
  <!-- Self-referencing required -->
  <link rel="alternate" hreflang="en" href="https://faion.net/en/article/" />
  <link rel="alternate" hreflang="uk" href="https://faion.net/uk/article/" />
  <link rel="alternate" hreflang="de" href="https://faion.net/de/article/" />
  <link rel="alternate" hreflang="x-default" href="https://faion.net/article/" />
</head>

Critical Rules:

Self-referencing tag required on every page
Bidirectional linking (if A → B, then B → A)
Use ISO 639-1 language codes (en, uk, de)
Use ISO 3166-1 Alpha 2 for regions (en-US, en-GB)
x-default for language selector or global page
Metadata (title, description) MUST match page language
Never combine hreflang with noindex

AI Search Optimization (AEO)

llms.txt Standard

txt

# llms.txt - https://faion.net/llms.txt

# Faion Network
> AI-powered framework for solopreneurs with 282 methodologies and 43 AI agents

## Core Pages
- About: https://faion.net/about/
- Pricing: https://faion.net/pricing/
- Documentation: https://faion.net/docs/

## Products
- Ultimate Solopreneur Guide: https://faion.net/guide/
- SDD Methodology: https://faion.net/sdd/

## Contact
- Email: [email protected]
- Support: https://faion.net/support/

## Exclusions
- /premium/* (subscription required)
- /admin/*

Purpose:

Provides AI crawlers with curated site structure
Clarifies canonical sources
Reduces hallucination risk
Emerging standard (like robots.txt for AI)

Structured Data for AI

json

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Faion Network",
  "description": "AI-powered framework for solopreneurs",
  "url": "https://faion.net",
  "founder": {
    "@type": "Person",
    "name": "Ruslan Faion"
  },
  "sameAs": [
    "https://twitter.com/faion",
    "https://linkedin.com/company/faion"
  ]
}

Key Schema Types:

Organization, Person (brand/author)
Article, BlogPosting (content)
Product, Offer (e-commerce)
FAQPage, HowTo (rich results + AI)
BreadcrumbList (navigation)
LocalBusiness (local SEO)

Schema Markup (JSON-LD)

Article Schema

json

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "SDD Methodology: Complete Guide",
  "description": "Learn Specification-Driven Development...",
  "image": "https://faion.net/images/sdd-guide.jpg",
  "author": {
    "@type": "Person",
    "name": "Ruslan Faion",
    "url": "https://faion.net/about/"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Faion Network",
    "logo": {
      "@type": "ImageObject",
      "url": "https://faion.net/logo.png"
    }
  },
  "datePublished": "2026-01-15",
  "dateModified": "2026-01-18"
}

Breadcrumb Schema

json

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://faion.net/"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Guides",
      "item": "https://faion.net/guides/"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "SDD Methodology"
    }
  ]
}

FAQ Schema

json

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is SDD?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "SDD (Specification-Driven Development) is..."
      }
    }
  ]
}

Social Meta Tags

Open Graph (Facebook, LinkedIn)

html

<meta property="og:type" content="article" />
<meta property="og:title" content="SDD Methodology Guide" />
<meta property="og:description" content="Learn how to build products faster..." />
<meta property="og:image" content="https://faion.net/og-image.jpg" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta property="og:url" content="https://faion.net/guides/sdd/" />
<meta property="og:site_name" content="Faion Network" />
<meta property="og:locale" content="en_US" />
<meta property="og:locale:alternate" content="uk_UA" />

Twitter Cards

html

<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:site" content="@faion" />
<meta name="twitter:creator" content="@ruslanfaion" />
<meta name="twitter:title" content="SDD Methodology Guide" />
<meta name="twitter:description" content="Learn how to build products faster..." />
<meta name="twitter:image" content="https://faion.net/twitter-image.jpg" />

Image Requirements:

Minimum: 1200x630px (1.91:1 ratio)
Max file size: 8MB
Formats: JPG, PNG, GIF, WebP
Always use absolute URLs

Core Web Vitals (2025)

Target Metrics

Metric	Good	Needs Improvement	Poor
LCP (Largest Contentful Paint)	≤ 2.5s	2.5s - 4s	> 4s
INP (Interaction to Next Paint)	≤ 200ms	200ms - 500ms	> 500ms
CLS (Cumulative Layout Shift)	≤ 0.1	0.1 - 0.25	> 0.25

Optimization Checklist

LCP:

Preload largest image: <link rel="preload" as="image" href="...">
Use WebP/AVIF formats (25-35% smaller)
Implement lazy loading for below-fold images
Optimize server response time (TTFB < 800ms)
Use CDN for static assets

INP:

Minimize main thread blocking
Break up long JavaScript tasks (< 50ms chunks)
Defer non-critical JS
Use requestIdleCallback for low-priority work

CLS:

Always include width/height on images
Reserve space for ads and embeds
Avoid inserting content above existing content
Use font-display: swap with font preload

Semantic HTML & Accessibility

Correct Structure

html

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Page Title | Site Name</title>
</head>
<body>
  <header role="banner">
    <nav aria-label="Main navigation">
      <ul>
        <li><a href="/">Home</a></li>
      </ul>
    </nav>
  </header>

  <main id="main-content">
    <article>
      <h1>Single H1 Per Page</h1>
      <p>Introduction...</p>

      <section aria-labelledby="section1">
        <h2 id="section1">Section Title</h2>
        <p>Content...</p>

        <h3>Subsection</h3>
        <p>More content...</p>
      </section>
    </article>

    <aside aria-label="Related content">
      <h2>Related Articles</h2>
    </aside>
  </main>

  <footer role="contentinfo">
    <p>&copy; 2026 Faion Network</p>
  </footer>
</body>
</html>

Accessibility Checklist

Headings: Logical hierarchy (H1 → H2 → H3), single H1
Images: Descriptive alt text, decorative images: alt=""
Links: Descriptive text (not "click here")
Forms: Labels associated with inputs
Color: Sufficient contrast (4.5:1 minimum)
Keyboard: All interactive elements focusable
ARIA: Use landmarks (banner, main, navigation, contentinfo)

Internal Linking Strategy

Pillar-Cluster Model

             ┌─────────────────┐
             │  Pillar Page    │
             │ (Head Keyword)  │
             └────────┬────────┘
        ┌─────────────┼─────────────┐
        ↓             ↓             ↓
   ┌─────────┐  ┌─────────┐  ┌─────────┐
   │ Cluster │  │ Cluster │  │ Cluster │
   │ (Long-  │  │ (Long-  │  │ (Long-  │
   │  tail)  │  │  tail)  │  │  tail)  │
   └─────────┘  └─────────┘  └─────────┘

Avoiding Keyword Cannibalization

Issue	Solution
Multiple pages targeting same keyword	Consolidate with 301 redirects
Similar content competing	Merge into comprehensive guide
Unclear primary page	Increase internal links to preferred page
Same anchor text for different pages	Use unique anchors per target page

Best Practices

One primary keyword per page → map keywords to URLs
Internal links from high-authority pages → pass link equity
Contextual links within content → better than footer/sidebar
Descriptive anchor text → tells Google what page is about
Regular audits → find orphan pages, broken links

Breadcrumbs

Implementation

html

<nav aria-label="Breadcrumb">
  <ol itemscope itemtype="https://schema.org/BreadcrumbList">
    <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
      <a itemprop="item" href="https://faion.net/">
        <span itemprop="name">Home</span>
      </a>
      <meta itemprop="position" content="1" />
    </li>
    <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
      <a itemprop="item" href="https://faion.net/guides/">
        <span itemprop="name">Guides</span>
      </a>
      <meta itemprop="position" content="2" />
    </li>
    <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
      <span itemprop="name">SDD Methodology</span>
      <meta itemprop="position" content="3" />
    </li>
  </ol>
</nav>

Rules:

3-5 levels maximum
Reflect actual site hierarchy
Last item = current page (no link)
Include JSON-LD schema
Visible on desktop (removed from mobile SERPs Jan 2025)

Quick Audits

Technical SEO Checklist

robots.txt configured correctly
XML sitemap submitted to Search Console
No duplicate content (canonical tags)
HTTPS everywhere
Mobile-friendly (responsive)
Core Web Vitals passing
No 4xx/5xx errors
Proper redirects (301, not chains)

On-Page SEO Checklist

Unique title tag (50-60 chars)
Meta description (120-160 chars)
Single H1 with primary keyword
Logical heading hierarchy
Internal links to related content
External links to authoritative sources
Image alt text
Schema markup

AI/AEO Checklist

llms.txt file created
Organization schema
FAQPage schema for Q&A content
Clear, factual content structure
Entity connections (author, organization)
Recent publish/update dates

References

references/technical-seo.md - robots.txt, sitemaps, crawl budget
references/multilingual.md - hreflang, URL structure
references/schema.md - JSON-LD templates
references/aeo.md - AI optimization, llms.txt
references/accessibility.md - WCAG, ARIA
references/performance.md - Core Web Vitals

Tools

Tool	Purpose
Google Search Console	Indexing, Core Web Vitals, errors
PageSpeed Insights	Performance analysis
Rich Results Test	Schema validation
Schema Validator	Schema.org validation
Ahrefs/Semrush	Backlinks, keywords, audits
Screaming Frog	Technical crawling
WAVE	Accessibility testing

Sources

Maintainer

majiayu000 Core maintainer

Source details

Full Name: majiayu000/claude-skill-registry
Branch: main
Path in repo: skills/other/faion-seo-skill
License: MIT License

Featured Tools

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31

Explore

majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31

Explore

majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31

Explore

majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31

Explore

majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31

Explore

majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31

Explore

Didn't find tool you were looking for?

Search AI Tools

Install this agent skill to your Project

SKILL.md

SEO & AEO Mastery

Quick Reference

Core Principles

1. Dual Optimization Strategy

2. E-E-A-T Framework

Technical SEO Fundamentals

robots.txt Best Practices

sitemap.xml Structure

Multilingual SEO & hreflang

URL Structure Options

hreflang Implementation

AI Search Optimization (AEO)

llms.txt Standard

Structured Data for AI

Schema Markup (JSON-LD)

Article Schema

Breadcrumb Schema

FAQ Schema

Social Meta Tags

Open Graph (Facebook, LinkedIn)

Twitter Cards

Core Web Vitals (2025)

Target Metrics

Optimization Checklist

Semantic HTML & Accessibility

Correct Structure

Accessibility Checklist

Internal Linking Strategy

Pillar-Cluster Model

Avoiding Keyword Cannibalization

Best Practices

Breadcrumbs

Implementation

Quick Audits

Technical SEO Checklist

On-Page SEO Checklist

AI/AEO Checklist

References

Tools

Sources

Recommended Agent Skills

agent-ops-spec

agent-ops-state

agent-ops-spec

agent-ops-testing

agent-ops-testing

agent-ops-state