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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.7 KB |
SKILL.md
View on GitHub---
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>
```
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 |