aycanozarpaci/seo-pro-max-skill

seo-pro-max is a shared instruction file (called a skill) that you drop into an AI coding assistant such as Claude Code, Cursor, Windsurf, Cline, or GitHub Copilot Chat. Its job is to help the assistant set up the search-engine and accessibility plumbing of a website, the kind of small but opinionated decisions a generic AI would otherwise pick on its own and often get wrong. The README is firm that the skill is an executor, not a decision-maker. It runs a Phase 0 analysis of the project first, asks the user the questions an assistant should not answer alone (like title strategy, where the admin panel lives, how the database stores per-page overrides, whether to emit a keywords meta tag), and only then writes code. The author lists current standards the skill enforces so the assistant does not suggest dead patterns: Google's removal of FAQPage rich results on May 7, 2026, the deprecation of rel=prev/next, the boundaries of IndexNow support (Bing and Yandex only, not Google), soft-404 detection, and BCP 47 hreflang validation. A quick start section explains the planned install once an npm package is published: a single npx seo-pro-max install command that auto-detects which AI coding tool is in use and drops the right file in the right place. Until then, the README provides per-platform manual install instructions using curl on macOS and Linux or Invoke-WebRequest on Windows PowerShell, with the right path for each tool (~/.claude/skills/.cursor/rules/.windsurfrules.clinerules.github/copilot-instructions.md, and so on). A long What it covers section lists the areas the skill touches: meta tags, indexing controls, correct HTTP status codes, robots.txt, XML sitemaps, Open Graph and Twitter cards, a recommendation matrix for Schema.org JSON-LD types, favicons and PWA manifests, search-engine verification, the llms.txt file (noted as not used by Google for AI ranking), admin-panel placement, database schema choices, per-page overrides, internationalisation, OG image generation, WCAG 2.2 AA accessibility checks, Core Web Vitals gates, image optimisation, URL and slug rules, internal linking and orphan detection, security headers, and client-side meta updates for single-page apps. The FAQPage section repeats that the skill does not emit FAQPage JSON-LD for new builds and uses QAPage for real community Q&A pages instead. The install section then gives copy-paste commands for nine different AI coding tools.