kai-topical-map

SkillSearch

Build an AEO-first topical map optimized for AI search citation — entity clusters, query fan-out coverage, information gain scoring, and multi-platform distribution. Produces entity map, content node architecture, schema blueprint, and 90-day publishing calendar. Use when "topical map", "content architecture", "site structure", "topic clusters", "pillar content plan", "AEO map", "AI search architecture", "entity map", "what content should we build", or any request to plan a site's topical structure for AI search visibility.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the kai-topical-map skill

What this skill tells your AI

The instructions your AI receives, as published by cgallic/kai-cmo-harness in harness/skills/kai-topical-map/SKILL.md and read by ahel’s review.

Objective

A topical map built for AI search and traditional search together: which entities the brand must own, which sub-queries each pillar has to satisfy, where the brand can say something nobody else can, which pages that implies, and in what order they publish. Every decision traces to retrievability, entity clarity, source quality, and measurable demand.

AI search visibility is sampled, volatile, and engine-specific. This skill does not promise citations. It builds the thing that can be measured — pages to create, entities to clarify, passages to make retrievable, sources to cite, and the follow-up checks that show whether any of it worked.

Done when

Work type strategy-plan (also_covers: topical-map) — floor E3/C3/O1 (harness/eco-floors.yaml).

  • E3 — a named human approved the exact content node architecture: entity clusters make strategic sense, hub-and-spoke groupings are right, information gain angles are achievable with data the brand actually has, no critical sub-query is missing, and the priority order by Citation Impact Score is correct.
  • C3banned_word_check clean, every structural gate below met, and a named non-producer read the map end to end.
  • O1 — the baseline AI Presence Scorecard is recorded before any page ships, with the re-read scheduled at 30/60/90 days. Each priority node names the query set it targets and who owns publishing it.

Structural gates, all mandatory:

GateBar
Entity mapEvery Tier 1 entity has a proposed Entity Home URL and a Wikidata action plan
Fan-out matrixEvery pillar has ≥6/8 sub-queries identified; pillars under 4/8 covered are priority gaps
Information gainEvery pillar has ≥2 "High" novelty opportunities, or is flagged for research before content creation
SchemaEvery prescribed schema type has every relevant attribute populated

Constraints

  • Read MARKETING.md from the project root before asking the user anything. If it does not exist, build it from the codebase — CLAUDE.md, README.md, PROJECT.md, package.json, landing pages, email/ad/analytics config — using the template from /kai-email-system, and confirm the draft.
  • Know these before mapping: the brand entity, the topic space, the existing content inventory (blog URLs, episodes, landing pages, guides), 2–3 competitors currently winning citations in the space, the target queries, and the current AI presence.
  • Baseline the AI presence with recorded conditions. Sample 3–5 category queries across ChatGPT, Perplexity, Bing/Copilot, and Google AI surfaces where available. Record prompt, location, date, engine, account state, citations, mentions, and missing-data caveats. This becomes the "before" measurement; re-run at 30/60/90 days.
  • Never paste a benchmark into a client-facing map without a source URL, retrieval date, evidence tier, confidence label, and fit note. Treat Knowledge Graph, Wikidata, vector-search, traffic, citation, and conversion claims as source-dependent context, not promised outcomes.
  • Case-study evidence needs method, measurement, source quality, applicability, and caveat before it informs a recommendation: what changed and whether a control existed; engine, prompt set, sample size, dates, geography, account state, and citation definition; official study vs vendor report vs internal measurement; whether the client's category, authority, depth, and distribution match; and what is still hypothesis.
  • Distribution must be transparent. Participate in communities openly. No astroturfing, no seeded fake threads, no hidden ownership, no manufactured consensus.
  • Do not compare AI and organic conversion rates without channel definitions, attribution windows, sample sizes, and confidence labels. Track AI traffic through source/medium rules, referrer inspection, landing-page cohorts, assisted conversions, and qualitative lead-source notes.
  • Schema does not substitute for useful visible content, and llms.txt is useful for cooperative agents, not a Google AI Overview ranking requirement.
  • This skill plans. It does not write pages or publish anything. The calendar hands off to /kai-content-calendar and /kai-write.

Context

NeedLoad
AEO strategy foundationknowledge/frameworks/aeo-ai-search/aeo-ai-search-playbook-2026.md
Entity tiers, Knowledge Graph, sameAsknowledge/frameworks/aeo-ai-search/entity-seo-knowledge-graph-deep-dive.md
Query decompositionknowledge/frameworks/aeo-ai-search/query-fan-out-guide.md
Page vs heading vs sentenceknowledge/frameworks/content-copywriting/qdp-qdh-qds-content-architecture.md
Novelty scoringknowledge/frameworks/aeo-ai-search/patent-information-gain-US12013887B2.md + knowledge/frameworks/aeo-ai-search/hidden-aeo-edges.md
Retrieval and ranking behaviorknowledge/frameworks/aeo-ai-search/geo-academic-research-synthesis.md + knowledge/frameworks/aeo-ai-search/perplexity-ranking-reverse-engineered.md
Brief structureharness/brief-schema.md
Calendar format compatibilityharness/skills/kai-content-calendar/SKILL.md
Product, ICP, voice, competitorsMARKETING.md (project root)

Entity tiers — every entity lands in one:

TierMeaningTreatment
1 — OwnBrand, product, founder, proprietary methodology namesEntity Home URL + Wikidata QID (or submission plan) + Schema.org markup
2 — AssociateIndustry terms, use cases, methodologies, problem categories, competitor categoriesContent cluster topics; co-occurrence builds context vectors that signal expertise
3 — ReferenceResearch institutions, standards bodies, regulators, recognized expertsCite for provenance and passage usefulness — no promised visibility lift

The site's @graph roots at Organization or Person with sameAs links (Wikidata, LinkedIn, Crunchbase, socials), knowsAbout listing Tier 2 entities, and mentions/about connecting pages to entities.

Query fan-out. Google's AI Mode decomposes a complex query into roughly 8 parallel sub-queries and synthesizes one answer with layered citations (Liz Reid, Google I/O 2025). Mine PAA 3–4 levels deep and categorize each sub-query by facet:

FacetExample for "AI phone answering"
Definition"What is an AI phone answering service?"
Cost"How much does AI phone answering cost?"
Process"How does AI phone answering work?"
Comparison"AI phone answering vs live receptionist"
Safety/Risk"Are AI phone answering services reliable?"
Timeline"How long to set up AI phone answering?"
Alternatives"Best AI phone answering services 2026"
Technical"AI phone answering integrations with CRM"

Route each sub-query by demand: QDP (high demand + distinct intent) gets its own URL, QDH (moderate) becomes a section inside a hub or spoke, QDS (low) becomes an inline sentence.

Information gain. The patent (US12013887B2) scores novelty against existing content via embeddings — paraphrase scores low however it is worded. Find the consensus across the top 5–10 results, then place the brand's angle:

IG categoryWhat it isWhy it works
Proprietary dataOriginal research, internal metrics, owned case studiesReported 3.2x citation rate in Perplexity analysis
Contrarian positionEvidence-backed views against consensusTriggers Perplexity's entropy diversity signal
Experience gapFirst-person specifics a model cannot fabricateRequired for E-E-A-T "Experience" (QRG 4.6.6)
Novel framingUnique terminology, frameworks, mental modelsCreates semantic distance from competitors
Second-click contentAnswers the follow-up query after the #1 resultCaptures recursive fan-out

Score each opportunity High (data or experience ready to publish), Medium (angle exists, research needed first), or Low (theoretical, no evidence).

Content nodes. Entity clusters become Hubs, QDP sub-queries become Spokes, QDH items become sections, QDS items become sentences. Each node declares URL, title, node type (Hub / Spoke / Entity Home), primary entity, fan-out queries answered, IG angle, and its citation-signal targets:

  • ≥3 sourced data points per page when the topic benefits from data
  • ≥1 permissioned quote or attributed expert source when claims need authority
  • ≥5 primary or high-quality secondary sources for research-heavy pages
  • 2–3 verifiable atomic facts per paragraph
  • 60–100 word paragraphs where that improves scannability and passage retrieval
  • 15–20 word sentence ceiling
  • Direct answer in the first 30–50 words after the H2

Schema prescription (eligibility and clarity, not guaranteed citation lift):

Node typeSchemaPurpose
FAQ / Q&AFAQPage where eligibleClarifies question-answer structure
How-to / processHowTo where eligibleClarifies steps, tools, prerequisites
Data / research / statsDataset where eligibleClarifies dataset ownership and fields
All informationalArticle or BlogPostingClarifies authorship, dates, subject
Entity HomeOrganization or Person + sameAsClarifies canonical identity

Incomplete or generic schema carries a reported 18% citation penalty versus no schema at all (Growth Marshal, Feb 2026) — populate every relevant attribute.

Citation Impact Score sets publishing order:

CIS (1-10) = (Fan-Out Coverage × 0.3) + (IG Novelty × 0.3) + (Entity Authority × 0.2) + (GEO Signal Density × 0.2)

Fan-Out Coverage  = (sub-queries answered / total for pillar) × 10
IG Novelty        = Low 3 · Medium 6 · High 10
Entity Authority  = Entity Home 10 · Hub with schema 7 · Spoke 4 · QDH section 2
GEO Signal Density= planned stats + quotes + citations per page, normalized to 10

Sequencing. Entity Home pages first (weeks 1–2, with Schema.org and Wikidata submissions together — entity authority has no shortcut). Hubs before their spokes. High-IG pages inside month 1, where freshness compounds novelty. Cross-cluster pages spread through the calendar to keep building entity connections.

Distribution. Each node gets a plan; publishing only on the site leaves most of the reachable surface untouched.

SurfaceFormatTiming
Own siteHub / Spoke pageDay 0
LinkedInArticle adaptation, 500–2,000 wordsDay 1–2
RedditDiscussion or comparison threadDay 3–5
Industry directoriesListing or review (G2, Capterra, Yelp per vertical)Week 1
Guest post / PRAdapted articleWeek 2–3
EngineWhat it leans onThe move
Gemini / Google AI surfacesGoogle Search crawl and indexHelpful, crawlable, snippet-eligible pages; schema; consistent subdomains
ChatGPTMixed retrieval, browsing, third-party consensusDirectory and review-site presence, "best of" inclusion, retrievable pages
PerplexityIndustry experts and niche directoriesVertical-specific: Zocdoc (health), Avvo (legal), G2 (SaaS)
Google AI OverviewsSearch ranking, retrieval, query fan-outSearch fundamentals, source quality, page-level answers, entity presence, freshness
Community / socialPublic discussion, professional contextParticipate transparently

What each citation signal is actually good for — use the left column for the middle column only, and carry the caveat:

SignalUse asCaveat
External citationsProvenance and source-quality supportNot a guaranteed AI visibility lift
Expert quotesAttributable authority and customer languageRequires permission and context
Statistics / dataSpecificity and answer usefulnessMust be sourced and current
Proprietary researchInformation gain and PR assetNeeds methodology disclosure
Topic clustersCoverage and internal linkingMeasure by queries and conversions, not vanity citation counts
FreshnessAccuracy maintenanceUpdate only when facts or examples change
Multi-platform distributionLegitimate audience discoveryNo astroturfing, hidden ownership, or fake consensus
SchemaEntity and content clarityNo substitute for useful visible content

Briefs for the first 4 weeks follow harness/brief-schema.md plus AEO extensions: information_gain_angle, fan_out_queries[], citation_signals (statistics/quotes/external citations required), entity_targets[], schema_type, a schema-completeness note, and a per-channel distribution_plan.

Output goes to workspace/topical-map/: _discovery.md, _entity-map.md, _fan-out-matrix.md, _information-gain-audit.md, _content-nodes.md, _schema-blueprint.json, _90-day-calendar.md, _distribution-plan.md, briefs/w[N]-[slug].json, _quality-report.md. The calendar is directly consumable by /kai-content-calendar.

Sources for the figures above: HubSpot AEO case studies (blog.hubspot.com/marketing/answer-engine-optimization-case-studies) · Superlines AI search statistics (superlines.io/articles/ai-search-statistics) · Yext AI visibility study (yext.com/blog/ai-visibility-in-2025-how-gemini-chatgpt-perplexity-cite-brands) · Semrush/ALM LinkedIn citations (almcorp.com/blog/linkedin-ai-search-citations-2026) · Schema App entity linking case study · Wellows AI Overview ranking factors · ALM AI Overview citation shifts · Discovered Labs on Reddit as an AEO signal source · GEO paper, Aggarwal et al. 2024 (Princeton/Georgia Tech) · Information Gain patent US12013887B2 (Carbune & Gonnet, 2024) · Query Fan-Out, Liz Reid, Google I/O 2025.

Escalate when

  • The brand has no proprietary data or first-hand experience for a pillar — that pillar needs research before it earns a content plan.
  • The topic space is regulated and the obvious content angles carry compliance risk.
  • Competitor citation positions cannot be observed and the gap analysis would be guesswork.
  • The user wants a citation, traffic, or ranking guarantee — that promise cannot be made.
  • Entity Home pages would require site changes the user has not authorized.
  • The plan's volume exceeds what the team can produce, and the priority cut needs a human decision.

Signals

GitHub stars
47
Forks
6
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
kai-topical-map
Source
github.com/cgallic/kai-cmo-harness