Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-seo-audit
saas-seo-audit
UnverifiedRun full-site SaaS SEO audit across crawlability, metadata, schema, CWV, and E-E-A-T.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.8 KB |
SKILL.md
View on GitHub---
name: saas-seo-audit
description: "Run full-site SaaS SEO audit across crawlability, metadata, schema, CWV, and E-E-A-T."
argument-hint: "[url]"
user-invocable: true
---
<!-- Generated from .claude/skills by scripts/sync-agent-skills.py. -->
## Running this workflow on this client
Run commands from the project root (use Git Bash on Windows if `bash` points to an unavailable WSL distro). Shared studio files live in `.claude/`; follow `.agents/PORTABLE-RUNTIME.md` and `.claude/docs/config-resolution.md` for client tools, delegation, and approval rules.
Run `bash .claude/hooks/yaml-helper.sh resolve_config --keys locale,review_mode,automation` and use its output below.
Resolved above — use as-is; `--review` overrides `review_mode` for this run.
# SaaS Platform Full SEO Audit
> **Locale & User Profile**: Match `locale` (`pt-BR` → natural Brazilian Portuguese questions/options, overriding English examples; `en` → English) and `user_profile` (`founder` → plain business language with `(Recomendado)` first, zero tech jargon; `developer` → technical). Keep code/tests in English.
Conducts an end-to-end, multi-vector SEO audit of a SaaS web application or staging server (`http://localhost:3000`).
---
## 1. Audit Pipeline
1. **URL Validation & Security Pre-Flight**:
- Check target URL with `python scripts/seo/url_safety.py`. Ensure SSRF protection and DNS pinning are engaged.
- If auditing local development environments, set `CLAUDE_SEO_LOCAL_TARGETS=localhost:3000`.
2. **Technical & Crawlability Evaluation**:
- Fetch and parse target URL using `python scripts/seo/parse_html.py <url> --json`.
- Verify robots.txt and XML sitemaps using `python scripts/seo/sitemap_discovery.py <url> --json`.
- Check for Googlebot 2MB fetch cap violations (oversized inline CSS/JS or base64 images).
3. **Schema.org Structured Data Audit**:
- Check JSON-LD blocks for SaaS entities: `SoftwareApplication`, `Organization`, `WebSite`, `Product`, `Offer`.
- Enforce 2026 schema deprecation rules (flag retired `FAQPage` or `HowTo` rich results).
4. **AI Search (GEO) & Citability**:
- Check for citable self-contained answer blocks (130-170 words answering query in first 40-60 words).
- Evaluate front-loaded content density (44% of citations emerge from the top 30% of page).
5. **Agentic Browsing Readiness**:
- Run `python scripts/seo/agentic_check.py <url> --json`.
- Audit `llms.txt`, Markdown endpoints (`Accept: text/markdown`), `ai-catalog.json`, and WebMCP markup.
- Run `python scripts/seo/lighthouse_agentic.py <url> --json` to compute the Lighthouse Agentic Browsing fraction (X/N).
6. **Search Experience (SXO) & Conversion Alignment**:
- Detect page-type mismatches (e.g. informational blog posts ranking for transactional tool queries).
- Audit time-to-value (TTV) and signup friction.
---
## 2. Output Format: Prioritized SaaS Action Plan
Structure the audit findings report into clear severity tiers:
```markdown
# SaaS SEO Health Report: [Target URL]
| Metric | Score / Status | Benchmark |
|---|---|---|
| Technical Crawlability | PASS / WARN | Clean robots.txt, 2MB cap respected |
| Schema.org JSON-LD | PASS / FAIL | Valid SoftwareApplication + Organization |
| Core Web Vitals (Lab) | Score (0-100) | LCP < 2.5s, CLS < 0.1, INP < 200ms |
| AI Search Citability (GEO) | High / Moderate | Self-contained 130-170w answer blocks |
| Lighthouse Agentic Browsing | X / N passed | Axe accessibility + llms.txt + WebMCP |
## P0 — Critical (Immediate Traffic / Crawl Loss Risk)
- [Issue description, evidence, exact Next.js code fix, verification step]
## P1 — High Impact (Search Visibility & GEO Citability)
- [Issue description, evidence, exact Next.js code fix, verification step]
## P2 — Medium Impact (Agent Readiness & SXO)
- [Issue description, evidence, recommendation]
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |