Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-seo-technical
saas-seo-technical
UnverifiedAudit 9-category technical SaaS SEO — SSR/ISR, robots.txt AI bots, canonicals, and sitemaps.
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.
Technical SEO Audit for SaaS
Locale & User Profile: Match
locale(pt-BR→ natural Brazilian Portuguese questions/options, overriding English examples;en→ English) anduser_profile(founder→ plain business language with(Recomendado)first, zero tech jargon;developer→ technical). Keep code/tests in English.
Audits technical SEO fundamentals for modern cloud applications, single-page apps (SPAs), and Next.js 14+ App Router architectures.
The 9 Technical Categories
-
Crawlability & Bot Governance:
robots.txt: Exists, valid syntax, reachable at root.- Distinct AI crawler rules: Distinguish training crawlers (
GPTBot,ClaudeBot,Bytespider,Google-Extended,Applebot-Extended,CCBot,Amazonbot) from search citability crawlers (OAI-SearchBot,Claude-SearchBot,PerplexityBot), and declareContent-Signalpreferences (ai-train,search,ai-input). - RFC 8288
Linkheaders & DNS-AID: ReturnLinkheaders on homepage (api-catalog,service-desc,service-doc,describedby) and publish_agentsSVCB/HTTPS/TXTDNS records where applicable. - 2MB HTML Cap: Ensure initial uncompressed HTML is strictly < 2MB (Googlebot limit; avoid bloated inline base64 or CSS).
-
Indexability & Meta Directives:
- Canonical tags: Self-referential, absolute URLs, no contradictory
noindexdirectives. - Meta robots: Enforce
index, follow, max-image-preview:large, max-snippet:-1, max-video-preview:-1.
- Canonical tags: Self-referential, absolute URLs, no contradictory
-
Rendering & JavaScript Architecture:
- Verify critical content and JSON-LD are delivered in initial server-rendered HTML (Next.js SSR/SSG).
- Ensure crawlers without full headless JS capabilities do not encounter empty
<div id="__next">shells.
-
URL Hierarchy & Slugs:
- Clean, lowercase, hyphenated URL paths.
- Trailing slash consistency. Avoid unmanaged query parameter bloat.
-
XML Sitemaps:
- Valid XML sitemap or Next.js
app/sitemap.tsdynamic generator. - Sitemaps listed in robots.txt. Large sites (>50k URLs) properly partitioned via sitemap index.
- Valid XML sitemap or Next.js
-
Core Web Vitals & Performance:
- Largest Contentful Paint (LCP) < 2.5s.
- Cumulative Layout Shift (CLS) < 0.1.
- Interaction to Next Paint (INP) < 200ms.
- Time to First Byte (TTFB) < 800ms.
-
Mobile Responsiveness & Viewport:
- Valid
<meta name="viewport" content="width=device-width, initial-scale=1">. - Touch targets >= 48px, readable typography, no horizontal scroll.
- Valid
-
Security & Transport:
- Enforce HTTPS with strict TLS 1.3/1.2.
- HSTS (
Strict-Transport-Security),X-Content-Type-Options: nosniff, and secure CSP.
-
Fast Indexation & Discovery (IndexNow):
- Instant notification of published/updated URLs via IndexNow API for Bing and Yandex.
Tool Execution
python scripts/seo/parse_html.py <url> --json
python scripts/seo/sitemap_discovery.py <url> --json
python scripts/seo/pagespeed_check.py <url>
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: 468k | 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: 468k | 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: 468k | 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 |