agents: Skill for Claude Code

SEO Specialist

Full-stack SEO expert for web and mobile. Specializes in Next.js App Router metadata system, JSON-LD schemas, Expo deep linking, and App Store Optimization.

Web SEO Quick Reference

Metadata Priority Order

1. generateMetadata() → dynamic pages (product, blog, user)
2. export const metadata → static pages
3. layout.tsx default → fallback

Per-Page Checklist

// generateMetadata or metadata export for every page
export const metadata: Metadata = {
  title: 'Page Title',           // ← unique, 50-60 characters
  description: 'Description',   // ← unique, 150-160 characters
  openGraph: { ... },            // ← social media sharing
  alternates: { canonical: '/url' }, // ← prevents duplicate content
}

JSON-LD Schema Selector

Page Type	Schema Type
Home	Organization + WebSite
Product detail	Product + BreadcrumbList
Blog post	Article + BreadcrumbList
Category	CollectionPage
About	AboutPage
Contact	ContactPage
FAQ	FAQPage
Event	Event

FAQPage Schema (powerful for conversions)

const faqJsonLd = {
  '@context': 'https://schema.org',
  '@type': 'FAQPage',
  mainEntity: faqs.map((faq) => ({
    '@type': 'Question',
    name: faq.question,
    acceptedAnswer: {
      '@type': 'Answer',
      text: faq.answer,
    },
  })),
}

WebSite Schema + Sitelinks Searchbox

const websiteJsonLd = {
  '@context': 'https://schema.org',
  '@type': 'WebSite',
  name: 'Site Name',
  url: 'https://yoursite.com',
  potentialAction: {
    '@type': 'SearchAction',
    target: {
      '@type': 'EntryPoint',
      urlTemplate: 'https://yoursite.com/search?q={search_term_string}',
    },
    'query-input': 'required name=search_term_string',
  },
}

---

Technical SEO — Next.js

Pagination SEO

// app/blog/page.tsx
interface Props {
  searchParams: { page?: string }
}

export async function generateMetadata({ searchParams }: Props): Promise<Metadata> {
  const page = Number(searchParams.page) || 1

  return {
    title: page > 1 ? `Blog — Page ${page}` : 'Blog',
    alternates: {
      canonical: page > 1 ? `/blog?page=${page}` : '/blog',
    },
    // Not noindex for pagination — just canonical
    robots: page > 1 ? { index: false } : { index: true },
  }
}