| name | entity-optimizer |
| description | Use when the user asks to "optimize entity presence"; builds Knowledge Graph, Wikidata, sameAs, and AI recognition signals for a canonical entity identity. Not for page-level AI-citation readiness — use geo-content-optimizer. 实体优化/知识图谱 |
| version | 9.9.12 |
| license | Apache-2.0 |
| compatibility | Claude Code and compatible agent-skill hosts |
| homepage | https://github.com/aaron-he-zhu/seo-geo-claude-skills |
| when_to_use | Use when optimizing entity presence for Knowledge Graph, Wikidata, or AI engine disambiguation. Also for brand entity canonicalization. |
| argument-hint | <entity name or brand> |
| metadata | {"author":"aaron-he-zhu","version":"9.9.12","geo-relevance":"high"} |
Entity Optimizer
Audits, 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.
Why entities matter for SEO + GEO:
- SEO: Google's Knowledge Graph powers Knowledge Panels, rich results, and entity-based ranking signals. A well-defined entity earns SERP real estate.
- 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.
What This Skill Does
Audits entity presence across Knowledge Graph, Wikidata, Wikipedia, and AI systems; maps all 6 signal categories (47 signals); produces a gap analysis, building plan, and disambiguation strategy.
Quick Start
Start with one of these prompts. Finish with a canonical entity profile and a handoff summary using the repository format in Skill Contract.
Entity Audit
Audit entity presence for [brand/person/organization]
How well do search engines and AI systems recognize [entity name]?
Build Entity Presence
Build entity presence for [new brand] in the [industry] space
Establish [person name] as a recognized expert in [topic]
Fix Entity Issues
My Knowledge Panel shows incorrect information — fix entity signals for [entity]
AI systems confuse [my entity] with [other entity] — help me disambiguate
Skill Contract
Expected output: an entity audit, a canonical entity profile, and a short handoff summary ready for memory/entities/.
- Reads: the entity name, primary domain, known profiles, topic associations, and prior brand context.
- Writes: a user-facing entity report plus a reusable profile that can be stored under
memory/entities/.
- Promotes: canonical names, sameAs links, disambiguation notes, and entity gaps to
memory/hot-cache.md, memory/entities/, and memory/open-loops.md.
- Done when: the 6 signal categories are each scored Pass/Fail/Partial, the AI-resolution test is run (or flagged as user-to-run), and a canonical profile plus top-5 priority actions are produced.
