Skip to main content
skill CX Codex

entity-seo — Claude Code skill: entity SEO and Knowledge Graph

Makes your brand, product and authors recognizable as distinct entities in search engines: Organization and Person schema, entity signals, cross-platform consistency.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add kostja94/marketing-skills --skill entity-seo -a claude-code
Open on GitHub

What entity-seo does

The skill covers entity-based SEO. Search engines stopped matching keywords and started reading meaning, so a clearly defined entity is easier to tell apart from a same-named one. Inside you get the definition of an entity, its attributes and relationships, plus a walkthrough of the Knowledge Graph and Knowledge Panel — how they work and what you can actually do about them.

Output includes an audit of identity gaps for brand, product and author, Organization and Person schema with @id for linking entities across pages, and a consistency checklist for name, logo and description across every touchpoint. For Organization, the skill advises placing the markup in the root layout rather than the homepage alone, so it lands on every page; an About page uses AboutPage instead.

It leans on neighbouring topics: schema-markup for the full placement table, eeat-signals for author signals, generative-engine-optimization for citation in AI answers. If you only need structured data markup and nothing about entity identity, reach for schema-markup — this one goes wider.

What it helps with

  • link brand, product and author into single entities for search engines
  • separate same-named entities so the brand is not confused with lookalikes
  • build Organization schema with @id and place it in the root layout
  • check that name, logo and description stay consistent across platforms
  • shape content that AI answers can cite

Example prompts for the agent

  • run an entity audit of the brand and find identity gaps
  • build Organization and Person schema with @id for entity linking
  • give me a consistency checklist for name and logo across all touchpoints

How to install entity-seo

1Skills CLI (Vercel)

npx skills add kostja94/marketing-skills --skill entity-seo -a claude-code

2Manually: put the files in place

~/.claude/skills/entity-seo/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/entity-seo/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about entity-seo

How do I install entity-seo in Claude?

Run npx skills add kostja94/marketing-skills --skill entity-seo -a claude-code. The skill lands in ~/.claude/skills/entity-seo/SKILL.md.

What does entity-seo do?

It helps optimize brand, product and author for entity recognition: identity audit, Organization and Person schema, a consistency checklist and Knowledge Panel work.

How is entity-seo different from schema-markup?

This one focuses on entity identity and relationships, while schema-markup handles the full placement table for every content type.

Source text

SKILL.md · MIT
---
name: entity-seo
description: When the user wants to optimize for entity recognition, Knowledge Graph, or entity-based SEO. Also use when the user mentions "entity SEO," "entity optimization," "Knowledge Graph," "Knowledge Panel," "entity signals," "brand entity," "entity linking," "entity relationships," or "entity-first content." For structured data, use schema-markup.
metadata:
  version: 1.0.1
---

# SEO: Entity SEO

Guides entity-based SEO—making your brand, product, and authors recognizable as distinct entities in search engines' knowledge systems. Google moved from keyword-matching to meaning-based understanding (Hummingbird, RankBrain, BERT, MUM); entity understanding is central to how search processes queries. Content structured around entities can receive ~3.2× more visibility in AI-powered search. References: [Semrush](https://www.semrush.com/blog/entity-based-seo-strategy/), [Search Engine Land](https://searchengineland.com/guide/entity-first-content-optimization).

**When invoking**: On **first use**, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output.

## Scope

- **Entity definition**: Singular, unique, well-defined things (person, place, organization, product, event)
- **Entity vs keyword**: Entities = underlying concepts; keywords = text strings
- **Knowledge Graph**: Google's entity database; powers disambiguation and related concepts
- **Implementation**: Schema (Organization, Person); entity signals in content; consistency across platforms

## What Is an Entity?

An **entity** is a thing or concept that is singular, unique, well-defined, and distinguishable—e.g. person, place, organization, product, event. Entities have:

| Attribute | Meaning |
|----------|---------|
| **Unique identity** | "Apple Inc." ≠ "apple (fruit)" despite same word |
| **Attributes** | Founding date, location, industry |
| **Relationships** | Connections to other entities (e.g. Apple Inc. → Steve Jobs, iPhone) |

**Entity SEO** = optimizing so search engines can identify, categorize, and connect your brand/product/author within the knowledge graph. Keywords are ambiguous; entities maintain consistent meaning across contexts.

## Why Entity SEO Matters

- **Search evolution**: Google uses entities to understand intent, not just match phrases
- **Knowledge Graph**: Billions of entities and relationships; disambiguation, related concepts
- **AI search**: Entity-optimized content ~3.2× more visible in AI results
- **E-E-A-T**: Entity signals support Experience, Expertise, Authoritativeness, Trust. See **eeat-signals**
- **GEO**: AI Overviews, Copilot, Perplexity cite entities; clear identity improves citation. See **generative-engine-optimization**

## Entity Signals (Content Best Practices)

| Practice | Purpose |
|----------|---------|
| **Clear brand/product name** | Consistent naming; avoid confusion with similar entities |
| **Author identity** | Person schema; author bio; link to author page |
| **Organization identity** | Organization schema site-wide; logo, sameAs |
| **Citable paragraphs** | Each block understandable on its own; supports AI extraction |
| **Consistency** | Same name, description, logo across website, social, directories |

## Schema for Entity SEO

### Organization

- **Placement**: **Minimum**—homepage; **Optimal**—root layout / global component (layout.tsx, _document, global header) so it appears on every page. Do **not** confine to About page; About uses AboutPage schema. See **schema-markup** for full placement table.
- **Required**: `@id`, `name`, `url`; add `logo`, `sameAs` (social, Wikidata)
- **Optional**: `description`, `address`, `contactPoint`; use most specific type (LocalBusiness, SoftwareApplication, etc.) when applicable

**@id**: Use stable URL (e.g. `https://example.com/#organization`) for entity linking across pages. Link Organization ↔ WebSite on homepage for sitelinks searchbox.

### Person

- **Use**: Author pages; Article author; team members
- **Properties**: `name`, `url`; `affiliation` (Organization); `sameAs` (LinkedIn, Twitter)
- **@id**: Enables entity linking; e.g. `https://example.com/author/jane/#person`

See **schema-markup** for full VideoObject, Article, Product, etc.; Organization and Person are core for entity SEO.

## Knowledge Panel & Knowledge Card

| Feature | Description | Obtainability |
|---------|-------------|---------------|
| **Knowledge Panel** | Entity info (brand, person, place) in SERP | WikiData, partnerships; most sites cannot directly obtain |
| **Knowledge Card** | Top-of-SERP semantic answer | Same as Knowledge Panel |

**Actions** (limited control):
- **Claim**: Google Business Profile; suggest updates when available
- **Consistency**: Same brand name, description, logo across all platforms
- **Entity Home**: Authoritative About page as primary reference
- **WikiData / Wikipedia**: Can support Knowledge Panel generation

See **serp-features** for Knowledge Panel in SERP context; **multi-domain-brand-seo** for Hub-Spoke entity consistency.

## Entity & Multi-Domain / Brand

When using multiple domains (Hub-Spoke):
- **Consistency**: Same brand name, description, logo across Hub and Spoke
- **Entity Home**: Authoritative About page on Hub as primary reference
- **Schema**: Organization with subOrganization for related entities
- **Entity confusion**: Avoid legacy brands, sub-brands, directories diluting brand perception

See **multi-domain-brand-seo** for full strategy.

## GEO & AI Citation

Entity signals strengthen GEO citation:
- **Direct-answer format** + **entity signals** = clearer AI extraction
- **Citable paragraphs** with clear brand/product/author identity
- **Distribution**: Website, YouTube, forums, Reddit—consistent entity identity across platforms

See **generative-engine-optimization** for full GEO strategy.

## Output Format

- **Entity audit** (brand, product, author identity gaps)
- **Schema** (Organization, Person; @id placement)
- **Consistency** checklist (name, logo, description across touchpoints)
- **Knowledge Panel** (claim if eligible; suggest updates)

## Related Skills

- **schema-markup**: Organization, Person; @id for entity linking
- **eeat-signals**: E-E-A-T; author bio; Person schema
- **generative-engine-optimization**: GEO; entity signals for AI citation
- **serp-features**: Knowledge Panel, Knowledge Card; SERP context
- **multi-domain-brand-seo**: Entity & Knowledge Panel; Hub-Spoke consistency
- **about-page-generator**: Entity Home; authoritative brand reference

© kostja94 · MIT · kostja94/marketing-skills

Similar skills

Everything for SEO and GEO →

From the same set125

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor