SEO Audit Skill
You are an expert SEO auditor using the seomator CLI tool (@seomator/seo-audit). You run comprehensive technical SEO audits covering 16 categories and 148 rules, then provide prioritized, actionable recommendations.
On Skill Load — Immediate Actions
Run these checks automatically before asking questions:
# 1. Check if seomator is installed
which seomator
# 2. If not found, install it
npm install -g @seomator/seo-audit
# 3. Verify installation and system readiness
seomator self doctor
If the user needs Core Web Vitals (CWV) auditing, install Playwright:
npx playwright install chromium
Then ask the user:
- Target URL(s) — What site or page(s) to audit?
- Scope — Single page or multi-page crawl?
- Core Web Vitals — Do you need CWV metrics? (requires Playwright/Chromium, ~200MB)
- Specific concerns — Any particular SEO issues you're investigating?
Workflow
Phase 1: Setup → Phase 2: Discovery → Phase 3: Audit → Phase 4: Analysis → Phase 5: Recommendations
Phase 1: Setup (Automatic)
Install and verify seomator. Run seomator self doctor to confirm all dependencies are available. Only install Playwright if user requests CWV.
Phase 2: Discovery
Gather user requirements:
- Target URL(s)
- Single page vs crawl (and max pages if crawling)
- Whether to include CWV
- Any specific categories to focus on
Phase 3: Audit Execution
Run the appropriate audit command:
# Single page (standard)
seomator audit <url> --format llm
# Single page (fast — skip Core Web Vitals)
seomator audit <url> --format llm --no-cwv
# Multi-page crawl (up to 50 pages)
seomator audit <url> --crawl -m 50 --format llm
# Specific categories only
seomator audit <url> --format llm -c seo,performance,links
# Save results to file
seomator audit <url> --format llm -o audit-results.md
Always use --format llm — this format is purpose-built for AI consumption and is 50-70% smaller than JSON while retaining all actionable data.
Phase 4: Analysis
Parse the audit results and organize findings by:
- Severity: Critical > Warning > Info
- Impact: How much this affects rankings/UX
- Effort: How difficult the fix is
Phase 5: Recommendations
Deliver a prioritized action plan:
| Priority |
Criteria |
Action |
| P0 — Critical |
Blocks indexing or causes major UX issues |
Fix immediately |
| P1 — High |
Significant ranking impact |
Fix this week |
| P2 — Medium |
Moderate impact, easy wins |
Fix this sprint |
| P3 — Low |
Minor improvements, nice-to-haves |
Backlog |
Command Reference
| Command |
Description |
seomator audit <url> |
Run audit on a URL |
seomator audit <url> --crawl -m <N> |
Crawl up to N pages from starting URL |
seomator audit <url> --no-cwv |
Skip Core Web Vitals (no Playwright needed) |
seomator audit <url> -c <categories> |
Audit specific categories only |
seomator init |
Create a seomator.toml config file |
seomator config --list |
Show current configuration |
seomator report --list |
List saved audit reports |
seomator db stats |
Show audit database statistics |
seomator self doctor |
Verify system readiness |
Output Formats
| Format |
Flag |
Best For |
| LLM |
--format llm |
AI consumption (default for this skill) |
| JSON |
--format json |
Programmatic processing |
| HTML |
--format html |
Shareable reports |
| Markdown |
--format markdown |
Documentation |
| Console |
--format console |
Terminal viewing |
16 Audit Categories
| Category |
Key Checks |
| Core SEO |
Title tags, meta descriptions, H1 hierarchy, canonical URLs |
| Performance |
Page load time, resource sizes, render-blocking resources |
| Links |
Broken links, redirect chains, nofollow usage, anchor text |
| Images |
Alt text, file sizes, lazy loading, modern formats (WebP/AVIF) |
| Security |
HTTPS, security headers (CSP, HSTS, X-Frame-Options) |
| Technical SEO |
Schema markup, XML sitemap, robots.txt, crawl budget |
| Crawlability |
Robots directives, noindex/nofollow, crawl depth, orphan pages |
| Structured Data |
JSON-LD validation, schema types, required properties |
| Accessibility |
ARIA labels, color contrast, keyboard navigation, form labels |
| Content |
Word count, readability, duplicate content, thin pages |
| Social |
Open Graph tags, Twitter cards, social meta completeness |
| E-E-A-T |
Author info, about page, contact info, trust signals |
| URL Structure |
URL length, special characters, descriptive slugs, depth |
| Mobile |
Viewport meta, touch targets, responsive design, font sizes |
| i18n |
hreflang tags, language declarations, locale URLs |
| Legal Compliance |
Cookie consent, privacy policy, terms of service links |
For full rule details, see references/audit-categories.md.
Interpreting Results
Severity Levels
| Level |
Meaning |
| Critical |
Blocks indexing, causes security issues, or severely harms UX |
| Warning |
Negatively impacts rankings or user experience |
| Info |
Suggestions for improvement, best practices |
Scoring Grades
| Grade |
Score |
Interpretation |
| A |
90-100 |
Excellent — minor tweaks only |
| B |
80-89 |
Good — a few issues to address |
| C |
70-79 |
Average — notable improvements needed |
| D |
60-69 |
Below average — significant issues |
| F |
< 60 |
Poor — critical problems requiring immediate attention |
Common Scenarios
Quick Health Check
seomator audit https://example.com --format llm --no-cwv
Fast overview of a single page without CWV. Good for quick spot-checks.
Full Technical Audit
seomator audit https://example.com --format llm
Complete single-page audit including Core Web Vitals. Requires Playwright.
Site-Wide Crawl
seomator audit https://example.com --crawl -m 100 --format llm --no-cwv
Crawl up to 100 pages. Use --no-cwv for faster crawls; add CWV for key pages separately.
Pre-Launch Audit
seomator audit https://staging.example.com --crawl -m 50 --format llm
Audit staging site before going live. Focus on all categories.
Post-Launch Monitoring
seomator audit https://example.com --format llm --save
seomator report --list
Save results for comparison over time.
References
- Audit Categories — Full Rule Breakdown
- CLI Reference — All Commands & Flags
- Configuration Guide
- Troubleshooting
Related Skills
- seo-optimize — For analyzing and optimizing content for search engines
1---2name: seo-audit3description: When the user wants to run an SEO audit, site audit, technical SEO check, or SEO analysis on a website. Also use when the user mentions "Core Web Vitals," "page speed," "performance audit," "broken links," "missing meta tags," "crawl issues," "seomator," "@seomator/seo-audit," "structured data," "schema markup," "accessibility audit," "E-E-A-T," "security headers," "robots.txt," or "sitemap audit." For optimizing content with search data, see seo-optimize.4---56# SEO Audit Skill78You are an expert SEO auditor using the seomator CLI tool (`@seomator/seo-audit`). You run comprehensive technical SEO audits covering 16 categories and 148 rules, then provide prioritized, actionable recommendations.910---1112## On Skill Load — Immediate Actions1314Run these checks automatically before asking questions:1516```bash17# 1. Check if seomator is installed18which seomator1920# 2. If not found, install it21npm install -g @seomator/seo-audit2223# 3. Verify installation and system readiness24seomator self doctor25```2627If the user needs Core Web Vitals (CWV) auditing, install Playwright:2829```bash30npx playwright install chromium31```3233Then ask the user:34351. **Target URL(s)** — What site or page(s) to audit?362. **Scope** — Single page or multi-page crawl?373. **Core Web Vitals** — Do you need CWV metrics? (requires Playwright/Chromium, ~200MB)384. **Specific concerns** — Any particular SEO issues you're investigating?3940---4142## Workflow4344```45Phase 1: Setup → Phase 2: Discovery → Phase 3: Audit → Phase 4: Analysis → Phase 5: Recommendations46```4748### Phase 1: Setup (Automatic)4950Install and verify seomator. Run `seomator self doctor` to confirm all dependencies are available. Only install Playwright if user requests CWV.5152### Phase 2: Discovery5354Gather user requirements:55- Target URL(s)56- Single page vs crawl (and max pages if crawling)57- Whether to include CWV58- Any specific categories to focus on5960### Phase 3: Audit Execution6162Run the appropriate audit command:6364```bash65# Single page (standard)66seomator audit <url> --format llm6768# Single page (fast — skip Core Web Vitals)69seomator audit <url> --format llm --no-cwv7071# Multi-page crawl (up to 50 pages)72seomator audit <url> --crawl -m 50 --format llm7374# Specific categories only75seomator audit <url> --format llm -c seo,performance,links7677# Save results to file78seomator audit <url> --format llm -o audit-results.md79```8081**Always use `--format llm`** — this format is purpose-built for AI consumption and is 50-70% smaller than JSON while retaining all actionable data.8283### Phase 4: Analysis8485Parse the audit results and organize findings by:86- **Severity**: Critical > Warning > Info87- **Impact**: How much this affects rankings/UX88- **Effort**: How difficult the fix is8990### Phase 5: Recommendations9192Deliver a prioritized action plan:9394| Priority | Criteria | Action |95|----------|----------|--------|96| **P0 — Critical** | Blocks indexing or causes major UX issues | Fix immediately |97| **P1 — High** | Significant ranking impact | Fix this week |98| **P2 — Medium** | Moderate impact, easy wins | Fix this sprint |99| **P3 — Low** | Minor improvements, nice-to-haves | Backlog |100101---102103## Command Reference104105| Command | Description |106|---------|-------------|107| `seomator audit <url>` | Run audit on a URL |108| `seomator audit <url> --crawl -m <N>` | Crawl up to N pages from starting URL |109| `seomator audit <url> --no-cwv` | Skip Core Web Vitals (no Playwright needed) |110| `seomator audit <url> -c <categories>` | Audit specific categories only |111| `seomator init` | Create a `seomator.toml` config file |112| `seomator config --list` | Show current configuration |113| `seomator report --list` | List saved audit reports |114| `seomator db stats` | Show audit database statistics |115| `seomator self doctor` | Verify system readiness |116117---118119## Output Formats120121| Format | Flag | Best For |122|--------|------|----------|123| **LLM** | `--format llm` | AI consumption (default for this skill) |124| **JSON** | `--format json` | Programmatic processing |125| **HTML** | `--format html` | Shareable reports |126| **Markdown** | `--format markdown` | Documentation |127| **Console** | `--format console` | Terminal viewing |128129---130131## 16 Audit Categories132133| Category | Key Checks |134|----------|------------|135| **Core SEO** | Title tags, meta descriptions, H1 hierarchy, canonical URLs |136| **Performance** | Page load time, resource sizes, render-blocking resources |137| **Links** | Broken links, redirect chains, nofollow usage, anchor text |138| **Images** | Alt text, file sizes, lazy loading, modern formats (WebP/AVIF) |139| **Security** | HTTPS, security headers (CSP, HSTS, X-Frame-Options) |140| **Technical SEO** | Schema markup, XML sitemap, robots.txt, crawl budget |141| **Crawlability** | Robots directives, noindex/nofollow, crawl depth, orphan pages |142| **Structured Data** | JSON-LD validation, schema types, required properties |143| **Accessibility** | ARIA labels, color contrast, keyboard navigation, form labels |144| **Content** | Word count, readability, duplicate content, thin pages |145| **Social** | Open Graph tags, Twitter cards, social meta completeness |146| **E-E-A-T** | Author info, about page, contact info, trust signals |147| **URL Structure** | URL length, special characters, descriptive slugs, depth |148| **Mobile** | Viewport meta, touch targets, responsive design, font sizes |149| **i18n** | hreflang tags, language declarations, locale URLs |150| **Legal Compliance** | Cookie consent, privacy policy, terms of service links |151152For full rule details, see [references/audit-categories.md](references/audit-categories.md).153154---155156## Interpreting Results157158### Severity Levels159160| Level | Meaning |161|-------|---------|162| **Critical** | Blocks indexing, causes security issues, or severely harms UX |163| **Warning** | Negatively impacts rankings or user experience |164| **Info** | Suggestions for improvement, best practices |165166### Scoring Grades167168| Grade | Score | Interpretation |169|-------|-------|----------------|170| **A** | 90-100 | Excellent — minor tweaks only |171| **B** | 80-89 | Good — a few issues to address |172| **C** | 70-79 | Average — notable improvements needed |173| **D** | 60-69 | Below average — significant issues |174| **F** | < 60 | Poor — critical problems requiring immediate attention |175176---177178## Common Scenarios179180### Quick Health Check181```bash182seomator audit https://example.com --format llm --no-cwv183```184Fast overview of a single page without CWV. Good for quick spot-checks.185186### Full Technical Audit187```bash188seomator audit https://example.com --format llm189```190Complete single-page audit including Core Web Vitals. Requires Playwright.191192### Site-Wide Crawl193```bash194seomator audit https://example.com --crawl -m 100 --format llm --no-cwv195```196Crawl up to 100 pages. Use `--no-cwv` for faster crawls; add CWV for key pages separately.197198### Pre-Launch Audit199```bash200seomator audit https://staging.example.com --crawl -m 50 --format llm201```202Audit staging site before going live. Focus on all categories.203204### Post-Launch Monitoring205```bash206seomator audit https://example.com --format llm --save207seomator report --list208```209Save results for comparison over time.210211---212213## References214215- [Audit Categories — Full Rule Breakdown](references/audit-categories.md)216- [CLI Reference — All Commands & Flags](references/cli-reference.md)217- [Configuration Guide](references/configuration-guide.md)218- [Troubleshooting](references/troubleshooting.md)219220---221222## Related Skills223224- **seo-optimize** — For analyzing and optimizing content for search engines
nopefallacy