Entity Optimizer

1---2name: entity-optimizer3description: 'Build entity presence in Knowledge Graph, Wikidata, AI systems for brand recognition and citations. 实体优化/知识图谱'4version: "9.0.0"5license: Apache-2.06compatibility: "Claude Code ≥1.0, skills.sh marketplace, ClawHub marketplace, Vercel Labs skills ecosystem. No system packages required. Optional: MCP network access for SEO tool integrations."7homepage: "https://github.com/aaron-he-zhu/seo-geo-claude-skills"8when_to_use: "Use when optimizing entity presence for Knowledge Graph, Wikidata, or AI engine disambiguation. Also for brand entity canonicalization."9argument-hint: "<entity name or brand>"10metadata:11  author: aaron-he-zhu12  version: "9.0.0"13  geo-relevance: "high"14  tags:15    - seo16    - geo17    - entity-optimization18    - knowledge-graph19    - knowledge-panel20    - brand-entity21    - wikidata22    - entity-disambiguation23    - 实体优化24    - エンティティ25    - 엔티티26    - entidad-seo27  triggers:28    # EN-formal29    - "optimize entity presence"30    - "build knowledge graph"31    - "improve knowledge panel"32    - "entity audit"33    - "establish brand entity"34    - "entity disambiguation"35    # EN-casual36    - "Google doesn't know my brand"37    - "no knowledge panel"38    - "establish my brand"39    - "establish my brand as an entity"40    - "get a Google knowledge card"41    - "no Wikipedia entry"42    # EN-question43    - "how to get a knowledge panel"44    - "how to build brand entity"45    # ZH-pro46    - "实体优化"47    - "知识图谱"48    - "品牌实体"49    - "知识面板"50    - "品牌词"51    - "品牌词优化"52    # ZH-casual53    - "品牌搜不到"54    - "没有知识面板"55    - "Google不认识我的品牌"56    # JA57    - "エンティティ最適化"58    - "ナレッジパネル"59    # KO60    - "엔티티 최적화"61    - "지식 패널"62    - "구글이 내 브랜드 모르는데?"63    - "지식 패널 만들려면?"64    # ES65    - "optimización de entidad"66    - "panel de conocimiento"67    # PT68    - "otimização de entidade"69    # Misspellings70    - "knowlege panel"71    - "enity optimization"72---73 74# Entity Optimizer75 76 77> **[SEO & GEO Skills Library](https://github.com/aaron-he-zhu/seo-geo-claude-skills)** · 20 skills for SEO + GEO · [ClawHub](https://clawhub.ai/u/aaron-he-zhu) · [skills.sh](https://skills.sh/aaron-he-zhu/seo-geo-claude-skills)78> **System Mode**: This cross-cutting skill is part of the protocol layer and follows the shared [Skill Contract](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/skill-contract.md) and [State Model](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/state-model.md).79 80 81Audits, builds, and maintains entity identity across search engines and AI systems. Entities — the people, organizations, products, and concepts that search engines and AI systems recognize as distinct things — are the foundation of how both Google and LLMs decide *what a brand is* and *whether to cite it*.82 83**Why entities matter for SEO + GEO:**84 85- **SEO**: Google's Knowledge Graph powers Knowledge Panels, rich results, and entity-based ranking signals. A well-defined entity earns SERP real estate.86- **GEO**: AI systems resolve queries to entities before generating answers. If an AI cannot identify an entity, it cannot cite it — no matter how good the content is.87 88**System role**: Canonical Entity Profile. It acts as the source of truth for entity identity, associations, and disambiguation across the library.89 90## When This Must Trigger91 92Use this when brand or entity identity needs to be established or verified — even if the user doesn't use entity terminology:93 94- User says "Google doesn't know my brand" or "no knowledge panel"95- Auto-recommended when `memory/entities/candidates.md` accumulates 3 or more uncanonized entity candidates from other skills96- Establishing a new brand/person/product as a recognized entity97- Auditing current entity presence across Knowledge Graph, Wikidata, and AI systems98- Improving or correcting a Knowledge Panel99- Building entity associations (entity ↔ topic, entity ↔ industry)100- Resolving entity disambiguation issues (your entity confused with another)101- Strengthening entity signals for AI citation102- After launching a new brand, product, or organization103- Preparing for a site migration (preserving entity identity)104- Running periodic entity health checks105 106## What This Skill Does107 1081. **Entity Audit**: Evaluates current entity presence across search and AI systems1092. **Knowledge Graph Analysis**: Checks Google Knowledge Graph, Wikidata, and Wikipedia status1103. **AI Entity Resolution Test**: Queries AI systems to see how they identify and describe the entity1114. **Entity Signal Mapping**: Identifies all signals that establish entity identity1125. **Gap Analysis**: Finds missing or weak entity signals1136. **Entity Building Plan**: Creates actionable plan to establish or strengthen entity presence1147. **Disambiguation Strategy**: Resolves confusion with similarly-named entities115 116## Quick Start117 118Start with one of these prompts. Finish with a canonical entity profile and a handoff summary using the repository format in [Skill Contract](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/skill-contract.md).119 120### Entity Audit121 122```123Audit entity presence for [brand/person/organization]124```125 126```127How well do search engines and AI systems recognize [entity name]?128```129 130### Build Entity Presence131 132```133Build entity presence for [new brand] in the [industry] space134```135 136```137Establish [person name] as a recognized expert in [topic]138```139 140### Fix Entity Issues141 142```143My Knowledge Panel shows incorrect information — fix entity signals for [entity]144```145 146```147AI systems confuse [my entity] with [other entity] — help me disambiguate148```149 150## Skill Contract151 152**Expected output**: an entity audit, a canonical entity profile, and a short handoff summary ready for `memory/entities/`.153 154- **Reads**: the entity name, primary domain, known profiles, topic associations, and prior brand context from [CLAUDE.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/CLAUDE.md) and the shared [State Model](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/state-model.md) when available.155- **Writes**: a user-facing entity report plus a reusable profile that can be stored under `memory/entities/`.156- **Promotes**: canonical names, sameAs links, disambiguation notes, and entity gaps to `memory/hot-cache.md`, `memory/entities/`, and `memory/open-loops.md`.157 158This skill is the sole writer of canonical entity profiles at `memory/entities/<name>.md`. Other skills write entity candidates to `memory/entities/candidates.md` only. When 3+ candidates accumulate, this skill should be recommended.159 160**Profile schema**: the frontmatter of every canonical entity profile follows the authoritative contract in [references/entity-geo-handoff-schema.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/entity-geo-handoff-schema.md). That schema defines which fields downstream skills (`geo-content-optimizer`, `schema-markup-generator`, `meta-tags-optimizer`, `ai-overview-recovery`) depend on. Do not omit required fields — the consumers will degrade gracefully to `DONE_WITH_CONCERNS` and surface an `open_loop` pointing back here.161 162- **Next handoff**: use the `Next Best Skill` below once the entity truth is clear.163 164### Handoff Summary165 166Emit this shape when finishing the skill (see [skill-contract.md §Handoff Summary Format](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/skill-contract.md) for the authoritative format):167 168- **Status**: DONE / DONE_WITH_CONCERNS / BLOCKED / NEEDS_INPUT169- **Objective**: what was analyzed, created, or fixed170- **Key Findings / Output**: the highest-signal result171- **Evidence**: URLs, data points, or sections reviewed172- **Open Loops**: blockers, missing inputs, or unresolved risks173- **Recommended Next Skill**: one primary next move174 175## Data Sources176 177> See [CONNECTORS.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/CONNECTORS.md) for tool category placeholders.178 179**With ~~knowledge graph + ~~SEO tool + ~~AI monitor + ~~brand monitor connected:**180Query Knowledge Graph API for entity status, pull branded search data from ~~SEO tool, test AI citation with ~~AI monitor, track brand mentions with ~~brand monitor.181 182**With manual data only:**183Ask the user to provide:1841. Entity name, type (Person, Organization, Brand, Product, Creative Work, Event)1852. Primary website / domain1863. Known existing profiles (Wikipedia, Wikidata, social media, industry directories)1874. Top 3-5 topics/industries the entity should be associated with1885. Any known disambiguation issues (other entities with same/similar name)189 190Without tools, Claude provides entity optimization strategy and recommendations based on information the user provides. The user must run search queries, check Knowledge Panels, and test AI responses to supply the raw data for analysis.191 192Proceed with the audit using public search results, AI query testing, and SERP analysis. Note which items require tool access for full evaluation.193 194## Instructions195 196When a user requests entity optimization:197 1982. **GDPR Art 6 lawful-basis prompt (for third-party persons, EU/EEA/UK data subjects)** — if the entity being canonicalized is an individual (founder, author, public figure) and may be an EU/EEA/UK resident, the skill MUST prompt the user before writing to `memory/entities/`: "You are about to create a canonical profile for a person. If this person is or may be an EU/EEA/UK resident, GDPR Art 6 requires a lawful basis: (1) consent, (2) legitimate interest, (3) contract, (4) other. For non-EU subjects, check local regimes (CCPA/CPRA, PIPEDA, LGPD, etc.). If unsure, skip and return NEEDS_INPUT." Only proceed if user confirms a basis. Advisory only — not legal advice. Reference: [memory-management §GDPR / Privacy Compliance](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/cross-cutting/memory-management/SKILL.md).199 200### Step 1: Entity Discovery201 202Establish the entity's current state across all systems.203 204```markdown205### Entity Profile206 207**Entity Name**: [name]208**Entity Type**: [Person / Organization / Brand / Product / Creative Work / Event]209**Primary Domain**: [URL]210**Target Topics**: [topic 1, topic 2, topic 3]211 212#### Current Entity Presence213 214| Platform | Status | Details |215|----------|--------|---------|216| Google Knowledge Panel | ✅ Present / ❌ Absent / ⚠️ Incorrect | [details] |217| Wikidata | ✅ Listed / ❌ Not listed | [QID if exists] |218| Wikipedia | ✅ Article / ⚠️ Mentioned only / ❌ Absent | [notability assessment] |219| Google Knowledge Graph API | ✅ Entity found / ❌ Not found | [entity ID, types, score] |220| Schema.org on site | ✅ Complete / ⚠️ Partial / ❌ Missing | [Organization/Person/Product schema] |221 222#### AI Entity Resolution Test223 224**Note**: Claude cannot directly query other AI systems or perform real-time web searches without tool access. When running without ~~AI monitor or ~~knowledge graph tools, ask the user to run these test queries and report the results, or use the user-provided information to assess entity presence.225 226Test how AI systems identify this entity by querying:227- "What is [entity name]?"228- "Who founded [entity name]?" (for organizations)229- "What does [entity name] do?"230- "[entity name] vs [competitor]"231 232| AI System | Recognizes Entity? | Description Accuracy | Cites Entity's Content? |233|-----------|-------------------|---------------------|------------------------|234| ChatGPT | ✅ / ⚠️ / ❌ | [accuracy notes] | [yes/no/partially] |235| Claude | ✅ / ⚠️ / ❌ | [accuracy notes] | [yes/no/partially] |236| Perplexity | ✅ / ⚠️ / ❌ | [accuracy notes] | [yes/no/partially] |237| Google AI Overview | ✅ / ⚠️ / ❌ | [accuracy notes] | [yes/no/partially] |238```239 240### Step 2: Entity Signal Audit241 242Evaluate entity signals across 6 categories. For the detailed 47-signal checklist with verification methods, see [references/entity-signal-checklist.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/cross-cutting/entity-optimizer/references/entity-signal-checklist.md).243 244Evaluate each signal as Pass / Fail / Partial with a specific action for each gap. The 6 categories are:245 2461. **Structured Data Signals** -- Organization/Person schema, sameAs links, @id consistency, author schema2472. **Knowledge Base Signals** -- Wikidata, Wikipedia, CrunchBase, industry directories2483. **Consistent NAP+E Signals** -- Name/description/logo/social consistency across platforms2494. **Content-Based Entity Signals** -- About page, author pages, topical authority, branded backlinks2505. **Third-Party Entity Signals** -- Authoritative mentions, co-citation, reviews, press coverage2516. **AI-Specific Entity Signals** -- Clear definitions, disambiguation, verifiable claims, crawlability252 253> **Reference**: Use the audit template in [references/entity-signal-checklist.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/cross-cutting/entity-optimizer/references/entity-signal-checklist.md) for the full 47-signal checklist with verification methods for each category.254 255### Step 3: Report & Action Plan256 257Produce an Entity Optimization Report with: overview (entity/type/date), signal category summary (6-category ✅/⚠️/❌ table with findings), critical issues, top 5 priority actions (impact × effort), entity building roadmap (Week 1-2 → Month 1 → Month 2-3 → Ongoing), and CORE-EEAT A07/A08 + CITE I01-I10 cross-reference.258 259> **Reference**: See [references/entity-signal-checklist.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/cross-cutting/entity-optimizer/references/entity-signal-checklist.md) for the full Step 3 report template.260 261### Save Results262 263After delivering findings to the user, ask:264 265> "Save these results for future sessions?"266 267If yes, write a dated summary to the appropriate `memory/` path using filename `YYYY-MM-DD-<topic>.md` containing:268- One-line verdict or headline finding269- Top 3-5 actionable items270- Open loops or blockers271- Source data references272 273If any veto-level issue was found (CORE-EEAT T04, C01, R10 or CITE T03, T05, T09), also append a one-liner to `memory/hot-cache.md` without asking.274 275## Validation Checkpoints276 277### Input Validation278- [ ] Entity name and type identified279- [ ] Primary domain/website confirmed280- [ ] Target topics/industries specified281- [ ] Disambiguation context provided (if entity name is common)282 283### Output Validation284- [ ] All 6 signal categories evaluated285- [ ] AI entity resolution tested with at least 3 queries286- [ ] Knowledge Panel status checked287- [ ] Wikidata/Wikipedia status verified288- [ ] Schema.org markup on primary site audited289- [ ] Every recommendation is specific and actionable290- [ ] Roadmap includes concrete steps with timeframes291- [ ] Cross-reference with CORE-EEAT A07/A08 and CITE I01-I10 noted292 293## Example294 295**User**: "Audit entity presence for Acme Analytics, our B2B SaaS analytics platform at acme-analytics.example"296 297**Output** (abbreviated): AI resolution test shows partial recognition — ChatGPT described it as a generic "analytics tool" without B2B specificity; not listed among enterprise analytics players; founder unknown to AI systems. Health summary flags missing Wikidata entry, no Knowledge Panel, and 3 priority actions — Wikidata submission, sameAs links, and a founder-bio page.298 299> **Reference**: See [references/example-audit-report.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/cross-cutting/entity-optimizer/references/example-audit-report.md) for the full entity audit report including AI resolution test results, entity health summary, top 3 priority actions, and CORE-EEAT/CITE cross-references.300 301## Tips for Success302 303> **Reference**: See [references/entity-signal-checklist.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/cross-cutting/entity-optimizer/references/entity-signal-checklist.md) for the full 7-item Tips for Success list (start with Wikidata, leverage sameAs, test AI recognition before/after, compounding signals, consistency > completeness, disambiguation-first, pair with CITE I-dimension).304 305## Entity Type Reference306 307> **Reference**: See [references/entity-type-reference.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/cross-cutting/entity-optimizer/references/entity-type-reference.md) for entity types with key signals, schemas, and disambiguation strategies by situation.308 309## Knowledge Panel & Wikidata Optimization310 311> **Reference**: See [references/knowledge-panel-wikidata-guide.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/cross-cutting/entity-optimizer/references/knowledge-panel-wikidata-guide.md) for Knowledge Panel claiming/editing, common issues and fixes, Wikidata entry creation, key properties by entity type, and AI entity resolution optimization.312 313## Reference Materials314 315Detailed guides for entity optimization:316- [references/entity-signal-checklist.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/cross-cutting/entity-optimizer/references/entity-signal-checklist.md) — Complete signal checklist with verification methods, Step 3 report template, and Tips for Success317- [references/knowledge-graph-guide.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/cross-cutting/entity-optimizer/references/knowledge-graph-guide.md) — Wikidata, Wikipedia, and Knowledge Graph optimization playbook318 319## Next Best Skill320 321- **Primary**: [schema-markup-generator](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/schema-markup-generator/SKILL.md) — turn entity truth into machine-readable implementation.322- **Also consider**:323  - [geo-content-optimizer](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/geo-content-optimizer/SKILL.md) — if the core gap is AI-engine recognition (ChatGPT / Perplexity don't know the brand).324  - [seo-content-writer](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/seo-content-writer/SKILL.md) — if a new About / founder page is needed to establish the entity.