seo-optimizer

The SEO Optimizer is a specialized agentic skill designed to transform web applications from invisible to discoverable by applying semantic communication principles. It goes beyond simple keyword stuffing, focusing on how search engines, social platforms, and AI crawlers interpret content. This tool is intended for developers, content managers, and SEO specialists working on modern web stacks including Next.js, Astro, React, and static HTML configurations.

By auditing existing technical foundations, the skill ensures that crawlers can efficiently index your content while providing rich, machine-readable data through JSON-LD schema markup. It guides users through a hierarchy of SEO needs—prioritizing content quality and technical accessibility before refining meta-optimizations and performance metrics like Core Web Vitals.

• Automated Codebase Analysis: Identifies frameworks and routing structures to apply framework-native optimization patterns.

• Technical SEO Auditing: Checks for critical elements including robots.txt, canonical URLs, viewport settings, and meta tags.

• Semantic Structured Data: Implements schema.org markup (JSON-LD) for articles, products, organizations, and FAQ pages to generate rich search results.

• Social Optimization: Manages Open Graph (OG) tags and Twitter Card configurations for optimal social platform rendering.

• Framework-Specific Strategy: Provides tailored guidance for Next.js app directories, Astro page structures, and React Router configurations.

• Always start by analyzing the current codebase to detect existing meta-tags and configuration files before applying changes.

• Prioritize the SEO hierarchy: Foundation (Content) > Access (Crawlers) > Semantics (Structured Data) > Metadata > Performance.

• Use descriptive, unique title tags (50-60 chars) and meta descriptions (150-160 chars) tailored to specific page types like landing pages, blogs, or documentation.

• Leverage framework-native idioms instead of generic hacks to ensure long-term maintainability and performance.

• Use structured data carefully, matching the schema type to the specific page content (e.g., Article, Product, Organization) to improve indexing accuracy.