Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-seo-geo
saas-seo-geo
UnverifiedOptimize SaaS pages for AI Overviews, ChatGPT Search, Perplexity, and Claude citations.
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.
Generative Engine Optimization (GEO) 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.
Optimizes SaaS landing pages, documentation, and product guides for citability across generative answer engines (Google AI Overviews, ChatGPT Search, Perplexity, Claude, Gemini).
1. Core Principles from Google AI Optimization Guide
- AI Optimization is Still SEO: Generative models cite pages that are fast, accessible, authoritative, and indexable.
- Brand Mentions Correlate 3x Stronger with AI Citations than Backlinks:
- YouTube presence & video transcript mentions: ~0.737 correlation.
- Reddit community discussions & reviews: High correlation.
- Wikipedia / Wikidata entity entries: High correlation.
- LinkedIn corporate & founder presence: Moderate correlation.
- Backlink Domain Rating (DR): ~0.266 (weak correlation).
2. Citability Heuristics & Content Architecture
- Front-Loaded Citable Blocks:
- 44% of AI citations originate in the top 30% of page content.
- Place self-contained answer blocks in the opening fold.
- Block Geometry (130-170 Words):
- Self-contained units that can be cited without lost context.
- Direct definition in the first 40-60 words:
"X is [definition] that enables [outcome] by [mechanism]...".
- Factual Grounding & Verifiable Data:
- Attribute facts to clear primary sources.
- Avoid vague marketing jargon ("best-in-class", "revolutionary"). Use concrete numbers, metrics, latency benchmarks, or pricing.
3. AI Crawler Access Matrix
Ensure app/robots.ts explicitly grants access to AI search engines while protecting private SaaS endpoints:
| Crawler | Purpose | Recommended Policy |
|---|---|---|
OAI-SearchBot | ChatGPT Search Indexing | Allow on public marketing/docs |
Claude-SearchBot | Claude Search Citability | Allow on public marketing/docs |
PerplexityBot | Perplexity Indexing | Allow on public marketing/docs |
GPTBot | OpenAI Model Training | Disallow if training opt-out desired |
ClaudeBot | Anthropic Model Training | Disallow if training opt-out desired |
Google-Extended | Gemini Model Grounding | Disallow if training opt-out desired |
4. Execution Workflow
- Fetch target URL using
python scripts/seo/parse_html.py <url> --json. - Evaluate heading hierarchy (H1 -> H2 -> H3) and answer front-loading.
- Compute citability score based on self-contained block density and factual precision.
- Deliver concrete rewritten copy blocks formatted as high-citability snippets.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |