How do I install the Faion SEO Skill skill?

Run npx skillmds@latest add majiayu000/faion-seo-skill in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Faion SEO Skill skill do?

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. It is listed under Marketing & Growth on SkillMD.

Is Faion SEO Skill safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Faion SEO Skill?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Faion SEO Skill free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Faion SEO Skill?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Faion SEO Skill by majiayu000 — Agent Skill

Name: Faion SEO Skill
Rating: 4.2 (5 reviews)
Author: majiayu000

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

# 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 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

<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

# 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: hello@faion.net
- 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

{
  "@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

{
  "@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

{
  "@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

{
  "@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)

<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

<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

<!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

<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

Faion SEO Skill

File contents