entity-seo

A reusable Claude skill (and plain playbook) for entity SEO: helping Google and AI-powered search understand who you are, what your company, brand and products are, and how they all relate to each other.

Your name is an entity. Your brand is an entity. Your company, if its name is different, is another. Every product and service you sell is one, and so is an idea, a method or a slogan. Entity SEO is mapping those entities, writing down why each relationship between them exists, and then reinforcing those relationships everywhere you publish: the JSON-LD graph, entity pages, titles, profiles, articles, images and video. Ranking for your own name against namesakes is one of the results it measures. It isn’t the whole job.

Full-site SEO, GEO (AI/generative search), and AEO (answer engines & voice) technique coverage is built in, and it’s legitimate tactics only.

How it works

The skill is split into actions that all read and update one saved map, entities.yaml, so your schema, profile copy and articles describe the same relationships:

Run /entity-seo with no argument and it picks the next action from where you are; name an action to run just that one (/entity-seo audit).

What’s inside

Works for individuals (map centred on a Person) and organizations (centred on an Organization, with brands, founders, products and locations).

Install it as a Claude skill

Clone into your Claude skills directory (the folder name becomes the skill name):

git clone https://github.com/saadsalmankhan/entity-seo-skill.git ~/.claude/skills/entity-seo

• Personal (just you): ~/.claude/skills/entity-seo/
• Per-project / shared with a team: /.claude/skills/entity-seo/ and commit it.

Restart Claude Code (or reload) so it picks up the new skill.

How to call it

1. Let it auto-trigger. Describe the goal:

   “Do entity SEO for me and my company.” “Google doesn’t connect me to the product I built.” “Another outranks me on Google.” “Audit my site for SEO, GEO and AEO and give me a scored report.”

2. Invoke it by name. /entity-seo (it picks the next action) or /entity-seo map, /entity-seo audit, etc.
3. Just read it. It’s plain Markdown; SKILL.md + references/ work as a standalone playbook.

It starts by asking for your name, domain and existing profiles, drafts the entity map from what’s already public, and asks you to confirm it before changing anything.

Use the scripts standalone

pip install google-auth
export GSC_KEY_PATH=/secure/path/sa-key.json
export GSC_SITE=sc-domain:example.org
export GSC_QUERIES="jane doe,jane doe designer,jane doe portfolio"
python3 scripts/gsc_rank.py

export KG_API_KEY=...   # Knowledge Graph Search API key, kept out of git
export KG_QUERIES="jane doe,acme labs,acme contrast checker"
export KG_DOMAINS="example.org"
python3 scripts/kg_check.py

See references/measurement.md for the one-time (free, no-billing) setup of both APIs.

Ground rules (baked into the skill)

• No guarantees of position #1; rankings vary by user/location and take weeks.
• Legitimate tactics only — no SERP scraping, no CAPTCHA solving, no bought links, no fake profiles.
• Only true relationships: no invented partnerships, products or awards.
• Truth & consistency across site, résumé, schema, and every profile.
• No stuffing: reinforce relationships where they fit naturally.
• Secrets stay secret (keys chmod 600, never committed).

Built by

Created by Saad Salman — a fintech product manager in Lahore. This is the entity-SEO playbook used on saadsalman.org; see the worked example and the skill’s page at saadsalman.org/projects/entity-seo. If it’s useful, a star helps others find it.

License

MIT — see LICENSE. Use it, fork it, improve it.