roier-seo_skill

Overview

This skill is a technical SEO auditor and fixer that runs Lighthouse/PageSpeed audits on live sites or local dev servers and applies automatic code-level fixes. It analyzes Performance, Accessibility, SEO, Best Practices and PWA scores, then implements improvements for meta tags, structured data, Core Web Vitals and common accessibility issues. Designed to detect Next.js, React, Vue, Nuxt and plain HTML projects and apply framework-aware fixes.

How this skill works

The tool runs a Lighthouse audit (requires Node.js and Chrome/Chromium) and returns category scores plus detailed findings for FCP, LCP, CLS, TBT and accessibility failures. It identifies framework files or package.json dependencies to choose appropriate fix patterns, then rewrites head/meta, JSON-LD, image and font assets, and accessibility attributes in the codebase. After applying fixes the audit can be rerun to verify improvements and produce JSON or human-readable summaries.

When to use it

• You want a full Lighthouse/PageSpeed audit for a live site or localhost.
• You need automated fixes for meta tags, Open Graph, Twitter Cards or canonical/robots settings.
• You want to add or repair structured data (JSON-LD) for search features.
• You need to improve Core Web Vitals (LCP, CLS, TBT) and image/font delivery.
• You need accessibility (WCAG) fixes such as alt text, contrast, labels and skip links.

Best practices

• Run the audit on a staging copy before applying automated fixes to production.
• Prioritize critical Core Web Vitals and accessibility errors before minor suggestions.
• Commit or snapshot the codebase so fixes are reversible and review changes before merging.
• Provide accurate site-wide metadata and brand names to ensure generated tags are consistent.
• Re-audit after changes and iterate until scores reach target thresholds.

Example use cases

• Audit and auto-fix SEO/meta issues on a Next.js site, updating app/layout or Head tags.
• Run Lighthouse on http://localhost:3000 during development to catch regressions early.
• Generate and insert JSON-LD Website, Organization or Article schema for improved SERP features.
• Optimize images and preload fonts to reduce LCP on content-heavy pages.
• Fix accessibility misses like missing alt attributes, low contrast, unlabeled form fields and add skip links.