- name
- seo-reporter
- description
- Audit a URL for SEO factors and generate an actionable markdown report. Use when asked to analyze, check, or audit a webpage's SEO performance. Covers title, meta description, heading structure, canonical tags, robots.txt, and sitemap.xml. Outputs a scored, readable markdown report with specific recommendations.
- metadata
SEO Reporter
Audit any URL for core SEO factors and get an actionable report with scores and recommendations.
When to Use
✅ USE this skill when:
- "Audit the SEO of [URL]"
- "Check [URL] for SEO issues"
- "SEO report for [URL]"
- "Analyze page SEO"
- "What SEO improvements for [URL]?"
When NOT to Use
❌ DON'T use this skill when:
- Full technical SEO crawl needed → use Screaming Frog, Ahrefs, or Semrush
- Page speed / Core Web Vitals → use PageSpeed Insights
- Backlink analysis → use Ahrefs/Moz
- Keyword research or content optimization → use dedicated SEO tools
- SSL/certificate checks → use
sslscanor online checkers
Input
A single URL (must include protocol: https://).
https://example.comOutput
A markdown SEO audit report covering:
| Factor | What It Checks |
|---|---|
| Title Tag | Presence, length (50-60 chars optimal), uniqueness |
| Meta Description | Presence, length (150-160 chars optimal), relevance |
| H1 Heading | Exactly one H1 present, content relevance |
| Heading Structure | H1→H2→H3 hierarchy, no missing levels, no multiple H1s |
| Canonical Tag | <link rel="canonical"> present and points to correct URL |
| Robots.txt | File exists, is accessible, and is not blocking important pages |
| Sitemap.xml | File exists, is accessible, and contains the audited URL |
| Open Graph Tags | OG title, description, and image present |
| Mobile Viewport | Viewport meta tag present |
| HTTPS | Page served over secure connection |
Each factor gets a score (Pass / Warning / Fail) and specific recommendations if issues are found.
Usage
Run the audit
URL="https://example.com"
./audit.sh "$URL"Inline from agent
The agent should run audit.sh with the target URL and present the output as a formatted markdown report.
cd /home/tim/.openclaw/workspace/skills/seo-reporter
./audit.sh "https://example.com"Report Format
# 🔍 SEO Audit Report: https://example.com
**Date:** YYYY-MM-DD
**URL:** https://example.com
---
## Scores
| Factor | Score | Status |
|---|---|---|
| Title Tag | 8/10 | ⚠️ Warning |
| Meta Description | 7/10 | ⚠️ Warning |
| H1 Heading | 10/10 | ✅ Pass |
| Heading Structure | 9/10 | ✅ Pass |
| Canonical Tag | 10/10 | ✅ Pass |
| Robots.txt | 8/10 | ⚠️ Warning |
| Sitemap.xml | 10/10 | ✅ Pass |
| Open Graph Tags | 5/10 | ❌ Fail |
| Mobile Viewport | 10/10 | ✅ Pass |
| HTTPS | 10/10 | ✅ Pass |
**Overall Score: 87/100**
---
## Detailed Findings
### ✅ Passed
- ...
### ⚠️ Warnings
- ...
### ❌ Issues Found
- ...
## Recommendations
1. ...
2. ...
---
*Report generated by seo-reporter skill*Scoring Guide
| Score | Meaning |
|---|---|
| 10/10 | Perfect — no issues |
| 7-9/10 | Good — minor improvements possible |
| 4-6/10 | Warning — meaningful issue that should be fixed |
| 0-3/10 | Fail — critical issue |
Tips
- Always validate the URL has a protocol prefix (
https://) before running - The audit is non-destructive (read-only HTTP requests)
- Run from the skill directory so relative paths to helpers work
- For comparing two pages, run the audit on both and diff the scores