SEO Auditor Agent Skill

SEO Auditor

A battle-tested SEO audit framework extracted from real-world high-traffic projects. Use this to systematically review any new website or page for SEO compliance.

Resources Included

• resources/seo_standards.md: The Core Knowledge Base. Detailed guidelines on Metadata, Schema, Content, and Performance standards.
• resources/checklist_template.md: A generalized Markdown checklist for auditing any page.
• resources/audit_rules.js: A simple Node.js script to check common SEO issues (H1, Meta Tags, Canonical).

Usage

1. Manual Audit (The Golden Standard)

For every significant page update or new feature:

• Read the Standards: Review resources/seo_standards.md to understand the *Why* and *How*.
• Create a Checklist: Copy resources/checklist_template.md to your project (e.g., docs/audits/PAGE_NAME_AUDIT.md).
• Verify & Check: Go through each item. Do not just tick the box—verify it against the standards.

2. Automated Check (Sanity Check)

Run the audit_rules.js script against your built HTML files to catch obvious errors:

# Example
node .agent/skills/seo-auditor/resources/audit_rules.js ./out/index.html

Quick Reference (Top 5 Rules)

• Title: 50-60 chars, unique, dynamic date (e.g. "(June 2026)").
• Canonical: ALWAYS set, ALWAYS use trailing slash (/path/).
• Schema: Use FAQPage (5+ Qs) or HowTo to capture rich results.
• Internal Links: Every page needs 3-6 outgoing links in a "Related" section.
• Performance: HTML size < 150KB, use <Image> component.