# Send Entity Optimizer to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "entity-optimizer",
    "name": "Entity Optimizer",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/aaron-he-zhu/entity-optimizer",
    "canonicalUrl": "https://clawhub.ai/aaron-he-zhu/entity-optimizer",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/entity-optimizer",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=entity-optimizer",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/entity-signal-checklist.md",
      "references/entity-type-reference.md",
      "references/example-audit-report.md",
      "references/knowledge-graph-guide.md",
      "references/knowledge-panel-wikidata-guide.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "entity-optimizer",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T09:25:13.219Z",
      "expiresAt": "2026-05-08T09:25:13.219Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=entity-optimizer",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=entity-optimizer",
        "contentDisposition": "attachment; filename=\"entity-optimizer-9.9.5.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "entity-optimizer"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/entity-optimizer"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/entity-optimizer",
    "downloadUrl": "https://openagent3.xyz/downloads/entity-optimizer",
    "agentUrl": "https://openagent3.xyz/skills/entity-optimizer/agent",
    "manifestUrl": "https://openagent3.xyz/skills/entity-optimizer/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/entity-optimizer/agent.md"
  }
}
```
## Documentation

### Entity Optimizer

SEO & GEO Skills Library · 20 skills for SEO + GEO · Install all: npx skills add aaron-he-zhu/seo-geo-claude-skills

Research · keyword-research · competitor-analysis · serp-analysis · content-gap-analysis

Build · seo-content-writer · geo-content-optimizer · meta-tags-optimizer · schema-markup-generator

Optimize · on-page-seo-auditor · technical-seo-checker · internal-linking-optimizer · content-refresher

Monitor · rank-tracker · backlink-analyzer · performance-reporter · alert-manager

Cross-cutting · content-quality-auditor · domain-authority-auditor · entity-optimizer · memory-management

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.

### When to Use This Skill

Establishing a new brand/person/product as a recognized entity
Auditing current entity presence across Knowledge Graph, Wikidata, and AI systems
Improving or correcting a Knowledge Panel
Building entity associations (entity ↔ topic, entity ↔ industry)
Resolving entity disambiguation issues (your entity confused with another)
Strengthening entity signals for AI citation
After launching a new brand, product, or organization
Preparing for a site migration (preserving entity identity)
Running periodic entity health checks

### What This Skill Does

Entity Audit: Evaluates current entity presence across search and AI systems
Knowledge Graph Analysis: Checks Google Knowledge Graph, Wikidata, and Wikipedia status
AI Entity Resolution Test: Queries AI systems to see how they identify and describe the entity
Entity Signal Mapping: Identifies all signals that establish entity identity
Gap Analysis: Finds missing or weak entity signals
Entity Building Plan: Creates actionable plan to establish or strengthen entity presence
Disambiguation Strategy: Resolves confusion with similarly-named entities

### 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

### Data Sources

See CONNECTORS.md for tool category placeholders.

With ~~knowledge graph + ~~SEO tool + ~~AI monitor + ~~brand monitor connected:
Query 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.

With manual data only:
Ask the user to provide:

Entity name, type (Person, Organization, Brand, Product, Creative Work, Event)
Primary website / domain
Known existing profiles (Wikipedia, Wikidata, social media, industry directories)
Top 3-5 topics/industries the entity should be associated with
Any known disambiguation issues (other entities with same/similar name)

Without 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.

Proceed with the audit using public search results, AI query testing, and SERP analysis. Note which items require tool access for full evaluation.

### Instructions

When a user requests entity optimization:

### Step 1: Entity Discovery

Establish the entity's current state across all systems.

### Entity Profile

**Entity Name**: [name]
**Entity Type**: [Person / Organization / Brand / Product / Creative Work / Event]
**Primary Domain**: [URL]
**Target Topics**: [topic 1, topic 2, topic 3]

#### Current Entity Presence

| Platform | Status | Details |
|----------|--------|---------|
| Google Knowledge Panel | ✅ Present / ❌ Absent / ⚠️ Incorrect | [details] |
| Wikidata | ✅ Listed / ❌ Not listed | [QID if exists] |
| Wikipedia | ✅ Article / ⚠️ Mentioned only / ❌ Absent | [notability assessment] |
| Google Knowledge Graph API | ✅ Entity found / ❌ Not found | [entity ID, types, score] |
| Schema.org on site | ✅ Complete / ⚠️ Partial / ❌ Missing | [Organization/Person/Product schema] |

#### AI Entity Resolution Test

**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.

Test how AI systems identify this entity by querying:
- "What is [entity name]?"
- "Who founded [entity name]?" (for organizations)
- "What does [entity name] do?"
- "[entity name] vs [competitor]"

| AI System | Recognizes Entity? | Description Accuracy | Cites Entity's Content? |
|-----------|-------------------|---------------------|------------------------|
| ChatGPT | ✅ / ⚠️ / ❌ | [accuracy notes] | [yes/no/partially] |
| Claude | ✅ / ⚠️ / ❌ | [accuracy notes] | [yes/no/partially] |
| Perplexity | ✅ / ⚠️ / ❌ | [accuracy notes] | [yes/no/partially] |
| Google AI Overview | ✅ / ⚠️ / ❌ | [accuracy notes] | [yes/no/partially] |

### Step 2: Entity Signal Audit

Evaluate entity signals across 6 categories. For the detailed 47-signal checklist with verification methods, see references/entity-signal-checklist.md.

Evaluate each signal as Pass / Fail / Partial with a specific action for each gap. The 6 categories are:

Structured Data Signals -- Organization/Person schema, sameAs links, @id consistency, author schema
Knowledge Base Signals -- Wikidata, Wikipedia, CrunchBase, industry directories
Consistent NAP+E Signals -- Name/description/logo/social consistency across platforms
Content-Based Entity Signals -- About page, author pages, topical authority, branded backlinks
Third-Party Entity Signals -- Authoritative mentions, co-citation, reviews, press coverage
AI-Specific Entity Signals -- Clear definitions, disambiguation, verifiable claims, crawlability

Reference: Use the audit template in references/entity-signal-checklist.md for the full 47-signal checklist with verification methods for each category.

### Step 3: Report & Action Plan

## Entity Optimization Report

### Overview

- **Entity**: [name]
- **Entity Type**: [type]
- **Audit Date**: [date]

### Signal Category Summary

| Category | Status | Key Findings |
|----------|--------|-------------|
| Structured Data | ✅ Strong / ⚠️ Gaps / ❌ Missing | [key findings] |
| Knowledge Base | ✅ Strong / ⚠️ Gaps / ❌ Missing | [key findings] |
| Consistency (NAP+E) | ✅ Strong / ⚠️ Gaps / ❌ Missing | [key findings] |
| Content-Based | ✅ Strong / ⚠️ Gaps / ❌ Missing | [key findings] |
| Third-Party | ✅ Strong / ⚠️ Gaps / ❌ Missing | [key findings] |
| AI-Specific | ✅ Strong / ⚠️ Gaps / ❌ Missing | [key findings] |

### Critical Issues

[List any issues that severely impact entity recognition — disambiguation problems, incorrect Knowledge Panel, missing from Knowledge Graph entirely]

### Top 5 Priority Actions

Sorted by: impact on entity recognition × effort required

1. **[Signal]** — [specific action]
   - Impact: [High/Medium] | Effort: [Low/Medium/High]
   - Why: [explanation of how this improves entity recognition]

2. **[Signal]** — [specific action]
   - Impact: [High/Medium] | Effort: [Low/Medium/High]
   - Why: [explanation]

3–5. [Same format]

### Entity Building Roadmap

#### Week 1-2: Foundation (Structured Data + Consistency)
- [ ] Implement/fix Organization or Person schema with full properties
- [ ] Add sameAs links to all authoritative profiles
- [ ] Audit and fix NAP+E consistency across all platforms
- [ ] Ensure About page is entity-rich and well-structured

#### Month 1: Knowledge Bases
- [ ] Create or update Wikidata entry with complete properties
- [ ] Ensure CrunchBase / industry directory profiles are complete
- [ ] Build Wikipedia notability (or plan path to notability)
- [ ] Submit to relevant authoritative directories

#### Month 2-3: Authority Building
- [ ] Secure mentions on authoritative industry sites
- [ ] Build co-citation signals with established entities
- [ ] Create topical content clusters that reinforce entity-topic associations
- [ ] Pursue PR opportunities that generate entity mentions

#### Ongoing: AI-Specific Optimization
- [ ] Test AI entity resolution quarterly
- [ ] Update factual claims to remain current and verifiable
- [ ] Monitor AI systems for incorrect entity information
- [ ] Ensure new content reinforces entity identity signals

### Cross-Reference

- **CORE-EEAT relevance**: Items A07 (Knowledge Graph Presence) and A08 (Entity Consistency) directly overlap — entity optimization strengthens Authority dimension
- **CITE relevance**: CITE I01-I10 (Identity dimension) measures entity signals at domain level — entity optimization feeds these scores
- For content-level audit: [content-quality-auditor](../content-quality-auditor/)
- For domain-level audit: [domain-authority-auditor](../domain-authority-auditor/)

### Input Validation

Entity name and type identified
 Primary domain/website confirmed
 Target topics/industries specified
 Disambiguation context provided (if entity name is common)

### Output Validation

All 6 signal categories evaluated
 AI entity resolution tested with at least 3 queries
 Knowledge Panel status checked
 Wikidata/Wikipedia status verified
 Schema.org markup on primary site audited
 Every recommendation is specific and actionable
 Roadmap includes concrete steps with timeframes
 Cross-reference with CORE-EEAT A07/A08 and CITE I01-I10 noted

### Example

Reference: See references/example-audit-report.md for a complete example entity audit report for a B2B SaaS company (CloudMetrics), including AI entity resolution test results, entity health summary, top 3 priority actions, and CORE-EEAT/CITE cross-references.

### Tips for Success

Start with Wikidata — It's the single most influential editable knowledge base; a complete Wikidata entry with references often triggers Knowledge Panel creation within weeks
sameAs is your most powerful Schema.org property — It directly tells search engines "I am this entity in the Knowledge Graph"; always include Wikidata URL first
Test AI recognition before and after — Query ChatGPT, Claude, Perplexity, and Google AI Overview before optimizing, then again after; this is the most direct GEO metric
Entity signals compound — Unlike content SEO, entity signals from different sources reinforce each other; 5 weak signals together are stronger than 1 strong signal alone
Consistency beats completeness — A consistent entity name and description across 10 platforms beats a perfect profile on just 2
Don't neglect disambiguation — If your entity name is shared with anything else, disambiguation is the first priority; all other signals are wasted if they're attributed to the wrong entity
Pair with CITE I-dimension for domain context — Entity audit tells you how well the entity is recognized; CITE Identity (I01-I10) tells you how well the domain represents that entity; use both together

### Entity Type Reference

Reference: See references/entity-type-reference.md for entity types with key signals, schemas, and disambiguation strategies by situation.

### Knowledge Panel & Wikidata Optimization

Reference: See 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.

### Reference Materials

Detailed guides for entity optimization:

references/entity-signal-checklist.md — Complete signal checklist with verification methods
references/knowledge-graph-guide.md — Wikidata, Wikipedia, and Knowledge Graph optimization playbook

### Related Skills

content-quality-auditor — CORE-EEAT items A07 (Knowledge Graph Presence) and A08 (Entity Consistency) directly relate
domain-authority-auditor — CITE I01-I10 (Identity dimension) measures entity signals at domain level
schema-markup-generator — Generate Organization, Person, Product, and other entity schema
geo-content-optimizer — Entity signals feed AI citation probability
competitor-analysis — Compare entity presence against competitors
backlink-analyzer — Branded backlinks strengthen entity signals
performance-reporter — Track branded search and Knowledge Panel metrics
memory-management — Store entity audit results for tracking over time
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: aaron-he-zhu
- Version: 3.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T09:25:13.219Z
- Expires at: 2026-05-08T09:25:13.219Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/entity-optimizer)
- [Send to Agent page](https://openagent3.xyz/skills/entity-optimizer/agent)
- [JSON manifest](https://openagent3.xyz/skills/entity-optimizer/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/entity-optimizer/agent.md)
- [Download page](https://openagent3.xyz/downloads/entity-optimizer)