Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-seo-agentic
saas-seo-agentic
UnverifiedAudit & implement IsItAgentReady Level 0-5 standards (RFC 9727, llms.txt, MCP cards, JWKS).
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.
Agentic Browsing & Agent-Native Readiness 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 and engineers SaaS platforms across 25 agent-readiness standards (5 categories + IsItAgentReady Level 0–5 maturity scale) and Google Lighthouse Agentic Browsing ($X/N$).
1. The 5 Agent-Readiness Categories & Maturity Levels
Read references/isitagentready-levels.md for the full Level 0–5 calculation rules:
- Discoverability (
references/dns-aid-and-link-headers.md):robots.txt(RFC 9309),sitemap.xml, RFC 8288Linkheaders (api-catalog,service-desc,service-doc,describedby), and DNS-AID (SVCB/HTTPS/TXTunder_agents.<domain>with DNSSEC).
- Content Accessibility (
references/discovery-and-markdown.md):/llms.txt,/llms-full.txt, andAccept: text/markdowncontent negotiation (Vary: Accept,x-markdown-tokens).
- Bot Access Control (
references/access-policy.md):- Explicit AI crawler
User-agentrules (OAI-SearchBot,Claude-SearchBot,PerplexityBot,GPTBot,ClaudeBot,Google-Extended,Applebot-Extended,CCBot,Bytespider,Amazonbot),Content-Signal, and Web Bot Auth (/.well-known/http-message-signatures-directoryJWKS).
- Explicit AI crawler
- API, Auth & Agent Discovery (
references/agent-auth-and-identity.md):/.well-known/api-catalog(RFC 9727),/.well-known/oauth-authorization-server/openid-configuration(RFC 8414 / OIDC),/.well-known/oauth-protected-resource(RFC 9728),/auth.md,/.well-known/mcp/server-card.json(SEP-1649),/.well-known/agent-card.json(A2A),/.well-known/agent-skills/index.json(RFC v0.2.0),/.well-known/ai-catalog.json(ARD 1.0 + CORS), WebMCP (document.modelContext.registerTool+AbortController+toolparamdescription), and Personal Agent Protocol (/.well-known/poppy.json, informational).
- Agentic Commerce & Machine Payments (
references/agentic-commerce-protocols.md):- x402 (
@x402/nextHTTP 402), MPP (/openapi.jsonx-payment-info), ACP (/.well-known/acp.json), and UCP (/.well-known/ucp).
- x402 (
2. Priority Hierarchy (P0 to P3)
| Priority | Check | Tool Check ID |
|---|---|---|
| P0 | Accessible names, valid ARIA roles, interactive elements exposed | agent-accessibility-tree |
| P0 | Cumulative Layout Shift (CLS) <= 0.1 | cumulative-layout-shift |
| P0 | Core content present in initial server-rendered HTML | server-rendered |
| P0 | robots.txt reachable with explicit AI crawler groups | robots-ai-groups |
| P1 | llms.txt present and compliant (# Title, link, 50+ chars) | llms-txt |
| P1 | Markdown via Accept: text/markdown (Vary: Accept) | markdown-delivery |
| P1 | XML Sitemap reachable | sitemap-reachable |
| P1 | Real 404 for unknown routes (catch-all 200 breaks discovery) | http-404 |
| P2 | RFC 8288 Link discovery response headers | link-headers |
| P2 | MCP Server Card, Agent Skills Index, API Catalog, Web Bot Auth JWKS, OAuth | well-known:* |
| P2 | WebMCP tools registered on document.modelContext | webmcp-entry-point |
| P3 | ARD ai-catalog.json, A2A Card, Poppy, Auth.md, DNS-AID, ACP, UCP, MPP | ard-catalog, auth-md, dns-aid, commerce:* |
3. Next.js 14+ App Router Scaffolds (templates/seo/)
When scaffolding agent-readiness into a Next.js App Router SaaS project, reuse the studio templates under templates/seo/:
templates/seo/robots-txt-route.ts->app/robots.txt/route.ts(supportsContent-SignalandAmazonbot)templates/seo/llms-txt-route.ts->app/llms.txt/route.tstemplates/seo/markdown-negotiation-middleware.ts->middleware.ts(Accept: text/markdown+ RFC 8288Linkheaders)templates/seo/agent-skills-index-route.ts->app/.well-known/agent-skills/index.json/route.tstemplates/seo/mcp-server-card-route.ts->app/.well-known/mcp/server-card.json/route.tstemplates/seo/api-catalog-route.ts->app/.well-known/api-catalog/route.tstemplates/seo/ai-catalog-route.ts->app/.well-known/ai-catalog.json/route.tstemplates/seo/auth-md-route.ts->app/auth.md/route.tstemplates/seo/web-bot-auth-jwks-route.ts->app/.well-known/http-message-signatures-directory/route.ts
4. Tool Execution & Draft Generation
# Full audit (25 standards + Level 0-5 maturity score)
python scripts/seo/agentic_check.py <url> --json
python scripts/seo/lighthouse_agentic.py <url> --json
# Generate reviewable drafts for missing files
python scripts/seo/agentic_fix.py agent-skills https://example.com --skills-dir .claude/skills
python scripts/seo/agentic_fix.py mcp-card --name "My SaaS MCP" --url https://example.com
python scripts/seo/agentic_fix.py api-catalog https://example.com
python scripts/seo/agentic_fix.py auth-md --name "My SaaS" --url https://example.com
python scripts/seo/agentic_fix.py poppy --name "My SaaS" --domain example.com
python scripts/seo/agentic_fix.py acp https://example.com
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: 470k | 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: 470k | 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: 470k | 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 |