Seo Reporter

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,...

Security Scan

The skill is internally consistent: it implements an SEO audit by running a local bash script that performs read-only HTTP requests with curl and produces a markdown report; it does not request credentials or install external code.

Purpose & Capability

The name/description (SEO audit) align with the actual artifacts: SKILL.md documents an audit workflow and audit.sh implements checks (title, meta, headings, canonical, robots, sitemap, OG, viewport, HTTPS). Required binary is only curl, which is appropriate.

Instruction Scope

Runtime instructions tell the agent to run ./audit.sh with a target URL. The script (visible portions) performs only read-only HTTP requests against the target and related derived URLs (robots.txt, sitemap.xml) and analyzes the returned HTML. It does not read unrelated system files or environment variables in the visible code. One operational note: the agent is instructed to run the script from the skill directory (normal for relative helpers).

Install Mechanism

There is no install spec (instruction-only + bundled script). Nothing is downloaded from external URLs during install. The code is provided as a local audit.sh script.

Credentials

The skill declares no required environment variables or credentials and the script does not read secrets in the visible sections. The requested permissions and access are proportional to an SEO auditor.

Persistence & Privilege

always:false and user-invocable: true. The skill does not request persistent privileges or modify other skills or system-wide agent settings in the visible code.

Assessment

The skill appears to do what it claims: a local bash script that issues read-only curl requests and produces a markdown audit. Before installing or running it, review the full audit.sh source (the provided listing is partially truncated in this review) to confirm there are no hidden network calls or data exfiltration steps. Avoid auditing internal-only URLs (localhost, internal IPs, intranet) from an agent running on a hosted/shared environment, since the script will fetch any URL you supply. If you don't trust the anonymous publisher (no homepage provided), run the script locally in a sandbox or inspect the entire file first.

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 sslscan or online checkers

Input

A single URL (must include protocol: https://).

https://example.com

Output

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