check-file
Quick SEO + AEO check on the current file or a specified page
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/akii-technologies-ltd/akii-seo-ai-search-optimizer/HEAD/commands/check-file.md -o ~/.claude/commands/check-file.mdcheck-file.md
# Quick SEO + AEO Check You are running a quick SEO + AEO check powered by Akii. ## Arguments `$ARGUMENTS` is the file to check. If empty, use current file from IDE context. ## Checks ### Title - Exists · 50–60 chars · includes target keyword · unique + compelling ### Meta description - Exists · 150–160 chars · includes target keyword · has CTA ### Headings - Exactly one H1 · logical hierarchy · keywords in H1 + H2s ### Images - All have alt · alt descriptive · modern format / framework optimization ### Structured data - JSON-LD present · schema type matches content · required properties filled ### Links - 3+ internal links · descriptive anchor text · no broken patterns ### Canonical + Open Graph + Twitter - Canonical set · og:title / og:description / og:image · Twitter card ### AEO — good writing structure (Google-compatible, AI-engine-friendly) This is *helpful structure*, not artificial AI-targeted chunking. Google's [AI Optimization Guide](https://developers.google.com/search/docs/fundamentals/ai-optimization-guide) rejects "chunking for AI" as a special signal but explicitly endorses *"paragraphs and sections, along with headings that provide a clear structure"*. The checks below help readers AND non-Google AI engines (ChatGPT, Claude, Perplexity, Copilot) extract clean answers — never frame them as "AI hacks": - Direct-answer lead paragraph ≤40 words - Each H2/H3 section standalone (could lift into ChatGPT/Perplexity answer) - Definition blocks where key terms introduced - If HowTo: 5–7 step imperative checklist - FAQ section if applicable + FAQPage schema ## Output ``` # Quick SEO + AEO Check — <file> ✅ Title: 54 chars, keyword present ✅ H1: unique, keyword present ⚠️ Meta: 187 chars (too long) ❌ Direct-answer lead: missing (AEO penalty) ✅ Schema: Article + FAQPage present ## Score: 68/100 ## Top 3 fixes 1. Add ≤40-word direct-answer lead → +10 AEO 2. Shorten meta to 155 chars → +5 SEO 3. Add 2 internal links to related cluster pages → +3 SEO ## Run next - /akii-seo-ai-search-optimizer:optimize-page (full SEO + AEO + GEO pass) ``` --- *File check powered by Akii — for continuous site-wide checks + AI visibility tracking, visit https://akii.com/?utm_source=plugin&utm_medium=command&utm_content=check-file&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.
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.
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.
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.