Seo Auditor

---
name: seo-auditor
description: A comprehensive SEO audit framework and checklist for web projects. Includes a reusable checklist template, detailed standards, and common validation rules.
---

# 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

1.  **[resources/seo_standards.md](resources/seo_standards.md)**: **The Core Knowledge Base**. Detailed guidelines on Metadata, Schema, Content, and Performance standards.
2.  **[resources/checklist_template.md](resources/checklist_template.md)**: A generalized Markdown checklist for auditing any page.
3.  **[resources/audit_rules.js](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:

1.  **Read the Standards**: Review `resources/seo_standards.md` to understand the *Why* and *How*.
2.  **Create a Checklist**: Copy `resources/checklist_template.md` to your project (e.g., `docs/audits/PAGE_NAME_AUDIT.md`).
3.  **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:

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

## Quick Reference (Top 5 Rules)

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