aiskillstore/marketplace / skills/aaron-he-zhu/entity-optimizer
entity-optimizer
VerifiedUse when the user asks to "optimize entity presence", reconcile an entity identity, or update canonical Knowledge Graph facts; audits and maintains machine-facing identity, sameAs, schema, disambiguation, and AI-recognition evidence through the entities registry. Not for page-level AI-citation readiness - use geo-content-optimizer; not for human-facing brand canon - use narrative-registry. 实体优化/知识图谱
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.8 KB |
| references/entity-signal-checklist.md | markdown | 6.4 KB |
| references/entity-type-reference.md | markdown | 1.8 KB |
| references/example-audit-report.md | markdown | 3.9 KB |
| references/knowledge-graph-guide.md | markdown | 2.4 KB |
| references/knowledge-panel-wikidata-guide.md | markdown | 3.2 KB |
| skill-report.json | config | 37.3 KB |
references/example-audit-report.md
View on GitHub# Example: Entity Optimization Report
Full example output for an entity audit request.
**User**: "Audit entity presence for Acme Analytics, our B2B SaaS analytics platform at acme-analytics.example"
**Output**:
```markdown
## Entity Optimization Report
### Entity Profile
**Entity Name**: Acme Analytics
**Entity Type**: Organization (B2B SaaS)
**Primary Domain**: acme-analytics.example
**Target Topics**: analytics platform, business intelligence, enterprise analytics
### AI Entity Resolution Test
Queries tested with results reported by user:
| Query | Result | Assessment |
|-------|--------|------------|
| "What is Acme Analytics?" | Described as "an analytics tool" with no further detail | Partial recognition -- generic description, no mention of B2B focus or key features |
| "Best analytics platforms for enterprises" | Acme Analytics not mentioned in any AI response | Not recognized as a player in the enterprise analytics space |
| "Acme Analytics vs Datadog" | Correctly identified as a competitor to Datadog, but feature comparison was incomplete and partially inaccurate | Partial -- entity is associated with the right category but attributes are thin |
| "Who founded Acme Analytics?" | No answer found by any AI system tested | Entity leadership not present in AI knowledge bases |
### Entity Health Summary
| Signal Category | Status | Key Findings |
|-----------------|--------|--------------|
| Knowledge Graph | Missing | No Wikidata entry exists; no Google Knowledge Panel triggers for branded queries |
| Structured Data | Partial | Organization schema present on homepage with name, url, and logo; missing Person schema for CEO and leadership team; no sameAs links to external profiles |
| Web Presence | Strong | Consistent NAP across LinkedIn, Twitter/X, G2, and Crunchbase; social profiles link back to acme-analytics.example; branded search returns owned properties in top 5 |
| Content-Based | Partial | About page exists but opens with marketing copy rather than an entity-defining statement; no dedicated author pages for leadership |
| Third-Party | Partial | Listed on G2 and Crunchbase; 2 industry publication mentions found; no awards or analyst coverage |
| AI-Specific | Weak | AI systems have only surface-level awareness; entity definition is not quotable from any authoritative source |
### Top 3 Priority Actions
1. **Create Wikidata entry** with key properties: instance of (P31: business intelligence software company), official website (P856: acme-analytics.example), inception (P571), country (P17)
- Impact: High | Effort: Low
- Why: Wikidata is the foundational knowledge base that feeds Google Knowledge Graph, Bing, and AI training pipelines; without it, the entity cannot be formally resolved
2. **Add Person schema for leadership team** on the About/Team page, including name, jobTitle, sameAs links to LinkedIn profiles, and worksFor pointing to the Organization entity
- Impact: High | Effort: Low
- Why: Addresses the "Who founded Acme Analytics?" gap directly; Person schema for key people creates bidirectional entity associations that strengthen organizational identity
3. **Build Wikipedia notability through independent press coverage** -- target 3-5 articles in industry publications (TechCrunch, VentureBeat, Analytics India Magazine) that mention Acme Analytics by name with verifiable claims
- Impact: High | Effort: High
- Why: Wikipedia notability requires coverage in independent reliable sources; press mentions simultaneously feed AI training data, build third-party entity signals, and create the citation foundation for a future Wikipedia article
### Cross-Reference
- **CORE-EEAT**: A07 (Knowledge Graph Presence) scored Fail, A08 (Entity Consistency) scored Pass -- entity optimization should focus on knowledge base gaps rather than consistency
- **CITE**: I-dimension weakest area is I01 (Knowledge Graph Presence) -- completing Wikidata entry and earning Knowledge Panel directly improves domain identity score
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |