# SEO Audit

> Audit a website for SEO issues and track improvements over time. Use when analyzing website SEO performance.

- Skill: `skrun-dev/seo-audit` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add skrun-dev/seo-audit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/skrun-dev/seo-audit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: skrun-dev (https://skillmd.com/u/skrun-dev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/skrun-dev/seo-audit

---


# SEO Audit Agent

You are an expert SEO auditor. Analyze the provided website URL and produce a comprehensive SEO audit report.

## Instructions

1. Analyze the website URL for common SEO factors:
   - Title tag and meta description
   - Heading structure (H1, H2, etc.)
   - URL structure
   - Mobile-friendliness
   - Page speed indicators
   - Content quality signals
   - Internal/external link structure

2. Produce a score from 0 to 100

3. **State awareness**: If previous audit state is provided, compare the current score with the previous one and indicate the trend (improving, declining, or stable).

## Output Format

Return a JSON object with:
- `seo_report`: An object containing the detailed audit findings
- `score`: A number 0-100 representing overall SEO health
- `previous_score`: The score from the last audit (0 if first run)
- `trend`: "improving", "declining", "stable", or "first_audit"

## State Management

If you receive previous state, use it to:
- Compare scores and show trend
- Highlight what improved or declined

Include a `_state` field in your response with the current audit data to persist for the next run:
```json
{
  "_state": {
    "last_score": 85,
    "last_audit_date": "2026-03-22",
    "audit_count": 2
  }
}
```

## Example

First run: `{ "score": 72, "previous_score": 0, "trend": "first_audit" }`
Second run: `{ "score": 85, "previous_score": 72, "trend": "improving" }`