Skip to content

Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-seo-technical

saas-seo-technical

Unverified

Audit 9-category technical SaaS SEO — SSR/ISR, robots.txt AI bots, canonicals, and sitemaps.

FileKindSize
SKILL.mdskill md3.7 KB
---
name: saas-seo-technical
description: "Audit 9-category technical SaaS SEO — SSR/ISR, robots.txt AI bots, canonicals, and sitemaps."
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.

# Technical SEO Audit for SaaS

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


Audits technical SEO fundamentals for modern cloud applications, single-page apps (SPAs), and Next.js 14+ App Router architectures.

---

## The 9 Technical Categories

1. **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 declare `Content-Signal` preferences (`ai-train`, `search`, `ai-input`).
   - RFC 8288 `Link` headers & DNS-AID: Return `Link` headers on homepage (`api-catalog`, `service-desc`, `service-doc`, `describedby`) and publish `_agents` `SVCB`/`HTTPS`/`TXT` DNS records where applicable.
   - 2MB HTML Cap: Ensure initial uncompressed HTML is strictly < 2MB (Googlebot limit; avoid bloated inline base64 or CSS).

2. **Indexability & Meta Directives**:
   - Canonical tags: Self-referential, absolute URLs, no contradictory `noindex` directives.
   - Meta robots: Enforce `index, follow, max-image-preview:large, max-snippet:-1, max-video-preview:-1`.

3. **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.

4. **URL Hierarchy & Slugs**:
   - Clean, lowercase, hyphenated URL paths.
   - Trailing slash consistency. Avoid unmanaged query parameter bloat.

5. **XML Sitemaps**:
   - Valid XML sitemap or Next.js `app/sitemap.ts` dynamic generator.
   - Sitemaps listed in robots.txt. Large sites (>50k URLs) properly partitioned via sitemap index.

6. **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.

7. **Mobile Responsiveness & Viewport**:
   - Valid `<meta name="viewport" content="width=device-width, initial-scale=1">`.
   - Touch targets >= 48px, readable typography, no horizontal scroll.

8. **Security & Transport**:
   - Enforce HTTPS with strict TLS 1.3/1.2.
   - HSTS (`Strict-Transport-Security`), `X-Content-Type-Options: nosniff`, and secure CSP.

9. **Fast Indexation & Discovery (IndexNow)**:
   - Instant notification of published/updated URLs via IndexNow API for Bing and Yandex.

---

## Tool Execution

```bash
python scripts/seo/parse_html.py <url> --json
python scripts/seo/sitemap_discovery.py <url> --json
python scripts/seo/pagespeed_check.py <url>
```
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall