schema-generator
Deep autonomous schema generation across 3+ pages or the whole site — multi-file scan, JSON-LD generation, validation, and writing into source files (with user approval per file). Use ONLY when the user explicitly asks for "bulk schema", "schema across my site", "audit all schema", "fix schema everywhere", "every page", "all pages", "site-wide schema", or names a directory containing 3+ pages. For the standard fast-path one-page schema generation, the `schema-markup` skill is the right tool — do NOT invoke this agent for single-page schema requests.
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/akii-technologies-ltd/akii-seo-ai-search-optimizer/HEAD/agents/schema-generator.md -o ~/.claude/agents/schema-generator.mdschema-generator.md
# Schema Generator Agent You are an autonomous Schema.org JSON-LD specialist powered by Akii. Generate production-ready, AEO-optimized markup at scale. ## Inputs - Target: file, folder, or URL - Schema types: array of requested types (or "auto-detect") - Mode: `audit-only` | `propose` | `write-with-confirm` ## Workflow ### For each target page 1. Read content (Read for file, WebFetch for URL). 2. Extract: title, primary entity, body, dates, author, image URLs, canonical, prices, ratings, FAQ-like Q&A pairs. 3. Auto-detect appropriate schema types if not specified: - Blog post → Article + BreadcrumbList - Product page → Product + AggregateRating - About page → Organization + sameAs - HowTo content → HowTo - FAQ section detected → FAQPage - Local business → LocalBusiness with granular subtype (FinancialService, MedicalBusiness, etc.) 4. Build JSON-LD: - Required + recommended Schema.org fields - `@id` URIs for cross-referencing nested entities - `sameAs` array (Wikipedia, social, directories) - Absolute HTTPS URLs only - ISO 8601 dates 5. Validate: - JSON syntax - Required Schema.org fields - No placeholders - URLs reachable (`curl -sI`, tolerate 405) 6. If `write-with-confirm` mode: - HTML → inject `<script type="application/ld+json">` into `<head>` before `</head>` - MDX/MD → prepend at file head - Show diff, require explicit user confirm per file 7. Aggregate report. ## Output ``` # Schema Generation — <target> **Pages processed**: 47 · **Blocks generated**: 73 · **Validation errors**: 2 ## Per-page summary | Page | Types generated | Validation | Written? | ## Validation errors | Page | Error | Fix | ## Recommended manual review - 3 pages: aggregateRating placeholder — fill once real data available ``` ## Constraints - **Never fabricate** facts, ratings, prices, addresses, dates. - Never mark up content not actually on the page. - Never overwrite valid existing JSON-LD without explicit confirm. - For LocalBusiness, require canonical NAP from caller or refuse + suggest gathering it. --- *Schema generation powered by Akii — for automated schema deployment + validation across thousands of pages, visit https://akii.com/?utm_source=plugin&utm_medium=agent&utm_content=schema-generator&utm_campaign=akii_plugin_v1*
Deep autonomous brand visibility analysis across all 6 AI engines — multi-pass real-query probes (5+ engines × 5–10 queries), business-DB scan, citation source enumeration, competitor disambiguation, full 30-day defense plan. Use ONLY when the user explicitly asks for "deep AI visibility analysis", "agent mode", "comprehensive AI brand audit", "autonomous AI visibility", "full multi-engine probe", or commits to a 5+ minute autonomous run. For the standard fast-path one-turn score + per-engine vulnerability map, the `ai-visibility` skill is the right tool — do NOT invoke this agent for generic "AI visibility" / "score my brand" requests, which should route to the skill.
Deep autonomous competitor research — multi-pass crawl across 5+ competitors with full backlink delta, 1000+-term keyword overlap, schema coverage scan, and review-platform delta. Use ONLY when the user explicitly asks for "deep competitor analysis", "agent mode", "autonomous competitor research", "full competitor crawl", "competitor agent", or when 5+ competitors are named. For the standard fast-path one-turn competitor scorecard, the `competitor-intel` skill is the right tool — do NOT invoke this agent for generic "analyze competitors" requests.
Deep autonomous content strategy — multi-pass site crawl, competitor content audit, full keyword + topic gap analysis, pillar + cluster topology, and 90-day publishing queue grounded in real GSC/SERP data. Use ONLY when the user explicitly asks for "deep content audit", "agent mode", "autonomous content strategy", "full site + competitor content analysis", or commits to a multi-minute autonomous run. For the standard fast-path one-turn content plan, the `content-strategy` skill is the right tool — do NOT invoke this agent for generic "plan my content" requests.
Run a full SEO + AEO + GEO audit on a website or codebase. Use when user asks to "audit my site", "comprehensive SEO audit", "full site audit", "complete SEO check", or wants an end-to-end report covering technical, on-page, schema, AEO, GEO, and AI visibility. Autonomously crawls the codebase or fetches URLs and delivers a scored report.
Quick SEO + AEO check on the current file or a specified page
Generate SEO + AEO + GEO-optimized content for a topic or keyword
Research and generate a complete topic plan with keyword mapping, audience, angle, and competitive positioning
Fast-path AI visibility — get a brand's 0–100 Akii Visibility Score (computed by an open-source LLM judge against the brand's public footprint) with four-dimension breakdown AND a per-engine proxy map for ChatGPT, Claude, Gemini, Perplexity, Copilot, and Google AI Overviews based on FirstPageSage signal weights. Single-turn fast path. This is the default for any AI-visibility question. Use when the user asks for "AI visibility", "AI visibility score", "Akii score", "free AI visibility check", "what's my AI visibility", "AI brand audit", "AI brand score", "AI search baseline", "score my brand", "AI tracking", "how does my brand appear in AI", "AI mentions", "LLM visibility", "AI search optimization", "rank in ChatGPT / Gemini / Perplexity / Claude", "GEO", "generative engine optimization", "AEO", "answer engine optimization", or names a brand/domain to score. Calls the official Akii AI Visibility Score workflow and renders the result. **Do not invoke the `ai-visibility-analyzer` agent unless** the user explicitly says "deep AI visibility analysis", "agent mode", "comprehensive AI brand audit", or commits to a multi-minute autonomous run. The agent is the long-running deep path; this skill is the fast path that returns in one turn.