Content & Marketing
AI SEO audit
Run /seo-audit and the agent checks your pages for SEO best practices — meta tags, heading structure, internal linking, image optimization, and content quality.
/seo-audit
Run a technical SEO audit on your website. Checks meta tags, heading structure, internal linking, page speed indicators, and content quality.
Capabilities
Rank higher
Technical SEO checks
Validates meta titles, descriptions, canonical URLs, heading hierarchy, and structured data across your pages.
Internal linking audit
Maps your internal link structure, identifies orphan pages, and suggests linking opportunities to improve crawlability.
Content quality
Evaluates content length, keyword usage, readability, and uniqueness. Flags thin content and duplicate title/description issues.
How It Works
How /seo-audit works
1
Type /seo-audit
Run the command on your website project. The agent reads your pages, templates, and content.
2
Agent audits everything
Meta tags, heading structure, internal links, images, and content are all evaluated against SEO best practices.
3
Get the report
Receive a prioritized report with critical issues, warnings, and opportunities. Fix the highest-impact items first.
Try It
Example prompts
/seo-audit /seo-audit check the blog pages /seo-audit identify orphan pages and missing internal links Full Skill Source
Use this skill in your project
Copy the full text below or download it as a markdown file. Place it in your project's .claude/commands/ directory to use it as a slash command.
---
name: seo-auditor
description: Perform a technical SEO audit on a website or set of pages, checking meta tags, performance signals, structured data, and content quality. Use when optimizing pages for search engines or diagnosing ranking issues.
allowed-tools: ["Read", "Bash", "Glob", "Grep", "WebFetch"]
---
# /seo-audit
Run a comprehensive technical SEO audit on a website's source files, analyzing meta tags, content structure, performance signals, and search engine best practices.
## What This Command Does
1. Scans page files for meta tag completeness and quality
2. Analyzes heading hierarchy and content structure
3. Checks for common technical SEO issues (broken links, missing alt text, etc.)
4. Evaluates structured data and Open Graph tags
5. Reviews sitemap and robots.txt configuration
6. Produces a prioritized audit report with specific fix recommendations
## Usage
```
/seo-audit [path-or-url] [--scope page|site]
```
**Examples:**
- `/seo-audit src/pages/` -- audit all pages in the site
- `/seo-audit src/pages/features.astro` -- audit a single page
- `/seo-audit --scope site` -- full site audit including config files
## Execution Steps
1. **Determine audit scope**
- **Single page**: Audit the specified page file
- **Directory**: Audit all page files in the directory
- **Full site**: Audit pages plus sitemap, robots.txt, redirects, and configuration
Identify the framework being used (Astro, Next.js, etc.) to understand where meta tags and configuration live.
2. **Audit meta tags**
For each page, check:
| Tag | Check | Severity |
|-----|-------|----------|
| `<title>` | Exists, 30-60 characters, unique across pages, includes primary keyword | Critical |
| `meta description` | Exists, 120-160 characters, includes call to action | Critical |
| `canonical` | Exists, points to correct URL, no duplicates | Critical |
| `og:title` | Exists, matches or supplements page title | High |
| `og:description` | Exists, compelling for social sharing | High |
| `og:image` | Exists, correct dimensions (1200x630), accessible URL | High |
| `twitter:card` | Set to `summary_large_image` for pages with images | Medium |
| `robots` | Not accidentally set to `noindex` on important pages | Critical |
| `viewport` | Set correctly for mobile responsiveness | Critical |
| `lang` attribute | Set on `<html>` element | Medium |
3. **Audit heading structure**
For each page:
- Verify exactly ONE `<h1>` tag exists
- Check heading hierarchy is sequential (h1 > h2 > h3, no skipping levels)
- Verify `<h1>` contains the page's primary keyword
- Check that headings are descriptive and not generic ("Section 1")
- Count heading distribution (too few = poor structure, too many = keyword stuffing)
4. **Audit content quality signals**
- **Word count**: Pages targeting search should have 300+ words of unique content
- **Internal linking**: Each page should link to at least 2-3 other pages on the site
- **External linking**: Outbound links to authoritative sources add credibility
- **Keyword usage**: Primary keyword appears in title, H1, first paragraph, and meta description
- **Image optimization**: All images have `alt` text, use modern formats (WebP/AVIF), have width/height attributes
- **Duplicate content**: Flag pages with substantially similar content
5. **Audit technical fundamentals**
- **Sitemap**: Check `sitemap.xml` exists and includes all important pages
- **Robots.txt**: Verify it exists, allows search engine crawling, references sitemap
- **HTTPS**: All URLs use HTTPS
- **Trailing slashes**: Consistent URL structure (all with or all without)
- **404 handling**: Custom 404 page exists
- **Redirects**: Check for redirect chains (A > B > C should be A > C)
- **Page speed signals**: Look for large unoptimized images, render-blocking scripts, excessive CSS
6. **Audit structured data**
Check for JSON-LD structured data:
- **Organization**: Company name, logo, social profiles
- **WebSite**: Site name, search action
- **BreadcrumbList**: Navigation breadcrumbs
- **Article/BlogPosting**: For blog posts (author, date, image)
- **Product**: For product pages (name, description, offers)
- **FAQ**: For FAQ sections
- Validate JSON-LD syntax is correct
7. **Audit mobile readiness**
- Viewport meta tag is set correctly
- No fixed-width elements that would cause horizontal scrolling
- Touch targets are appropriately sized (minimum 44x44px)
- Font sizes are readable without zooming (minimum 16px body)
- No intrusive interstitials mentioned in the code
8. **Generate the audit report**
## Output Format
```markdown
# SEO Audit Report
**Scope**: [What was audited]
**Date**: [Current date]
**Pages Analyzed**: [Count]
**Framework**: [Detected framework]
---
## Score Summary
| Category | Score | Issues |
|----------|-------|--------|
| Meta Tags | [A-F] | [Count] |
| Content Structure | [A-F] | [Count] |
| Technical | [A-F] | [Count] |
| Structured Data | [A-F] | [Count] |
| Mobile | [A-F] | [Count] |
| **Overall** | **[A-F]** | **[Total]** |
---
## Critical Issues (Fix Immediately)
### 1. [Issue Title]
- **Page(s)**: [Affected pages]
- **Problem**: [What's wrong]
- **Impact**: [Why it matters for SEO]
- **Fix**: [Specific code change or action needed]
---
## High Priority Issues
### 1. [Issue Title]
...
---
## Medium Priority Issues
### 1. [Issue Title]
...
---
## Page-by-Page Summary
| Page | Title | Meta Desc | H1 | OG Tags | Issues |
|------|-------|-----------|-----|---------|--------|
| / | OK | OK | OK | Missing og:image | 1 |
| /features | Too long | OK | OK | OK | 1 |
---
## Recommendations
### Quick Wins (< 1 hour)
- [Action item]
### Medium Effort (1-4 hours)
- [Action item]
### Strategic (Requires planning)
- [Action item]
---
## Appendix: SEO Checklist
- [ ] All pages have unique title tags (30-60 chars)
- [ ] All pages have meta descriptions (120-160 chars)
- [ ] All pages have exactly one H1
- [ ] All images have alt text
- [ ] Sitemap is complete and submitted
- [ ] Structured data validates without errors
- [ ] No broken internal links
- [ ] Mobile experience is clean
```
## Scoring Rubric
| Grade | Meaning |
|-------|---------|
| A | No issues found in this category |
| B | Minor issues only (informational) |
| C | A few medium issues that should be addressed |
| D | Significant issues affecting SEO performance |
| F | Critical problems that likely harm rankings |
## Error Handling
- **No pages found at path**: Ask the user to confirm the pages directory location
- **Framework not recognized**: Fall back to generic HTML analysis
- **Build artifacts vs. source**: Always analyze source files, not build output
## Best Practices
- Run this audit before every major launch or redesign
- Focus on Critical and High priority issues first; diminishing returns below that
- SEO improvements compound over time; small consistent fixes beat big one-time efforts
- Pair with `/landing-page` when creating new pages to build SEO-friendly from the start
- Re-audit monthly to catch regressions from new content or code changes
Related Skills
Skills that work well together
Explore More