Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-seo
saas-seo
UnverifiedSaaS SEO, GEO & Agentic Readiness hub — technical, schema, AI search, llms.txt, and drift.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.2 KB |
| references/backlink-quality.md | markdown | 3.4 KB |
| references/cwv-thresholds.md | markdown | 7.5 KB |
| references/eeat-framework.md | markdown | 7.2 KB |
| references/eeat-scoring-guide.md | markdown | 1.5 KB |
| references/free-backlink-sources.md | markdown | 6.2 KB |
| references/local-schema-multilocation.md | markdown | 1.4 KB |
| references/local-schema-types.md | markdown | 8.0 KB |
| references/local-search-behavior.md | markdown | 2.8 KB |
| references/local-seo-signals.md | markdown | 7.7 KB |
| references/maps-api-endpoints.md | markdown | 6.1 KB |
| references/maps-free-apis.md | markdown | 6.0 KB |
| references/maps-gbp-checklist.md | markdown | 6.0 KB |
| references/maps-geo-grid.md | markdown | 4.3 KB |
| references/quality-gates.md | markdown | 5.9 KB |
| references/schema-types.md | markdown | 9.2 KB |
| references/thinking-framework-validate-act.md | markdown | 3.1 KB |
| references/thinking-framework.md | markdown | 6.6 KB |
SKILL.md
View on GitHub---
name: saas-seo
description: "SaaS SEO, GEO & Agentic Readiness hub — technical, schema, AI search, llms.txt, and drift."
argument-hint: "[command] [url|args]"
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 SEO Command Center
> **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.
Master command hub for SaaS search optimization, generative AI search visibility (GEO), autonomous agent readiness, and on-page technical integrity.
---
## 1. Quick Command Dispatch
| Command | Skill Routed | Primary Objective |
|---|---|---|
| `/saas-seo audit <url>` | `saas-seo-audit` | Full multi-agent SaaS website audit & prioritized fix plan |
| `/saas-seo technical <url>` | `saas-seo-technical` | 9-category technical crawlability, SSR/SSG rendering, robots.txt |
| `/saas-seo schema <url>` | `saas-seo-schema` | Schema.org JSON-LD generation (SoftwareApplication, Organization) |
| `/saas-seo geo <url>` | `saas-seo-geo` | Generative Engine Optimization (AI Overviews, Perplexity, ChatGPT) |
| `/saas-seo agentic <url>` | `saas-seo-agentic` | Lighthouse Agentic Browsing (X/N), llms.txt, WebMCP, discovery |
| `/saas-seo content <url>` | `saas-seo-content` | SaaS value messaging, E-E-A-T, AI text humanization & watermarks |
| `/saas-seo competitor-pages [url]`| `saas-seo-competitor-pages` | High-converting 'X vs Y' and 'Alternatives to X' pages |
| `/saas-seo programmatic [plan]` | `saas-seo-programmatic` | Scaled template pages (tools, directories) with <40% thin-content gate |
| `/saas-seo sxo <url> [keyword]` | `saas-seo-sxo` | Search Experience Optimization & SERP intent mismatch detection |
| `/saas-seo drift <cmd> <url>` | `saas-seo-drift` | Git-like SQLite baseline snapshotting and CI/CD regression diffs |
| `/saas-seo scaffold [component]` | internal | Scaffold Next.js 14+ SEO files (robots.ts, sitemap.ts, llms.txt) |
| `/saas-seo doctor` | internal | Check Python runtime readiness and dependencies without modifying system |
---
## 2. Bundled Python Execution Engine
All bundled CLI tools live in `scripts/seo/` and execute with zero external network bloat and built-in SSRF protection:
```bash
python scripts/seo/parse_html.py <url> --json
python scripts/seo/agentic_check.py <url> --json
python scripts/seo/drift_baseline.py <url>
python scripts/seo/drift_compare.py <url>
python scripts/seo/schema_generate.py profile --script-tag
```
For local development servers (`http://localhost:3000`), the engine safely allows loopback inspection when `CLAUDE_SEO_LOCAL_TARGETS=localhost:3000` is present.
---
## 3. Next.js 14+ App Router Code Generation Standards
Whenever implementing SEO features directly into a SaaS codebase, strictly generate code conforming to Next.js App Router conventions:
1. **Static & Dynamic Metadata**: Use `export const metadata: Metadata` or `export async function generateMetadata(): Promise<Metadata>`.
2. **Granular AI Crawler Management**: Generate `app/robots.ts` (or `app/robots.txt/route.ts` when emitting `Content-Signal` headers) explicitly distinguishing AI training bots (`GPTBot`, `ClaudeBot`, `Google-Extended`, `Amazonbot`, `Applebot-Extended`, `CCBot`) from AI search citability bots (`OAI-SearchBot`, `Claude-SearchBot`, `PerplexityBot`).
3. **Dynamic Sitemaps**: Generate `app/sitemap.ts` implementing `MetadataRoute.Sitemap`.
4. **Agentic Discovery & Machine-Readable Endpoints**: Implement `app/llms.txt/route.ts`, `Accept: text/markdown` content negotiation + RFC 8288 `Link` headers, and `/.well-known/` manifests (`agent-skills/index.json`, `mcp/server-card.json`, `api-catalog`, `ai-catalog.json`, `oauth-protected-resource`, `http-message-signatures-directory`, `auth.md`) targeting IsItAgentReady Level 4–5.
5. **JSON-LD Structured Data**: Deliver server-rendered `<script type="application/ld+json">` components to ensure instant indexing by crawlers without client-side hydration delays.
---
## 4. Execution Workflow
1. **Identify Request Intent**: Route single-domain requests to the respective specialized `/saas-seo-*` skill.
2. **Execute Diagnostic Check**: If URL is provided, run `scripts/seo/parse_html.py` or `scripts/seo/agentic_check.py`.
3. **Formulate Findings**: Structure findings into **Critical (P0)**, **High (P1)**, **Medium (P2)**, and **Low (P3)**.
4. **Draft Code or Recommendations**: Provide copy-pasteable Next.js 14+ components or configuration files.
5. **Ask for Approval**: Follow the studio 5-step collaborative loop before writing to disk: `"May I write this to [filepath]?"`
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |