johnpang1020/seo-ai-search-skill

Overview

This skill is an expert SEO and AI-search optimizer that generates dynamic metadata, JSON-LD structured data, and social tags for improved discoverability. It focuses on entity linking, intent signals, and SPA-friendly implementations to surface rich results and AI snippets. Use it to produce copy-paste-ready metadata, Schema.org JSON-LD, and a React SEOHead component when needed.

How this skill works

I first capture the page type, audience, primary entities, and target SERP/AI goals. I analyze provided code or content for missing or duplicated metadata and semantic gaps. Then I produce page-specific <title>, meta description, canonical, hreflang, Open Graph/Twitter tags, and minimal valid JSON-LD blocks plus SPA injection guidance. Final output includes React-ready SEOHead code, validation links, and a short optimization checklist.

When to use it

• Building or auditing page-level metadata for web pages and SPAs (React/Next/Vite).
• Creating Schema.org JSON-LD for Article, Product, FAQ, HowTo, Event, Organization, BreadcrumbList.
• Improving AI discoverability via entity linking and intent-focused content structure.
• Prepping pages for rich results, knowledge graph signals, or social sharing previews.
• Fixing SPA crawlability: dynamic head injection, prerender hints, sitemap and robots guidance.

Best practices

• Always produce page-specific metadata; avoid global duplicates unless explicitly requested.
• Keep JSON-LD minimal and valid (@context: https://schema.org), test with Rich Results and Schema validator.
• Use dynamic injection in SPAs (next/head, react-helmet-async, or a custom SEOHead component).
• Structure content semantically (one H1, clear H2/H3 sections, lists for steps/data) and include entity mentions with authoritative links.
• Provide canonical and hreflang when needed to prevent duplicate indexing and signal language/region.

Example use cases

• Generate an SEOHead React component with dynamic title, description, Open Graph and canonical tags for a product page.
• Create Article JSON-LD plus FAQ schema to increase chances of rich results and snippet inclusion.
• Audit a Next.js SPA for missing metadata, suggest prerender hints and sitemap updates for crawlability.
• Add entity linking and knowledge-graph hints to a topical hub page to improve AI contextual relevance.
• Produce hreflang and canonical strategy for multilingual sites to avoid duplicate content issues.