entity-brand-consistency
Skill0 starsChanged 2 months agoMITView on GitHub
Make a brand resolve as a single, consistent entity across the web so search engines and language models describe it correctly. Use whenever the user mentions entity SEO, knowledge panel, knowledge graph, Wikidata, sameAs, brand SERP, brand disambiguation, "Google shows the wrong information about us", AI assistants describing the company incorrectly, or a rebrand or name change. Also use when a brand is confused with a similarly named company in search or AI answers.
In this repository29 other files it gives its agents.
- ai-bot-log-analysisSkill
- ai-crawler-policySkill
- ai-visibility-auditSkill
- best-of-listicle-pagesSkill
- canonical-duplicate-contentSkill
- comparison-alternatives-pagesSkill
- content-refreshSkill
- core-web-vitalsSkill
- ecommerce-seoSkill
- eeat-author-pagesSkill
- featured-snippet-passagesSkill
- glossary-definition-hubSkill
- hreflang-international-seoSkill
- image-seoSkill
- internal-linking-architectureSkill
- keyword-cannibalizationSkill
- keyword-research-briefsSkill
- link-building-outreachSkill
- local-seoSkill
- nextjs-seoSkill
- programmatic-seoSkill
- redirect-migration-planSkill
- schema-markupSkill
- search-console-analysisSkill
- shopify-seoSkill
- technical-seo-auditSkill
- topical-authority-mapSkill
- video-seoSkill
- wordpress-seoSkill
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 7 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Search engines and language models both work with entities rather than strings.
- Distinctive: line 16
Do this before changing anything, and do it in a clean browser session with no personalisation.
- Distinctive: line 24
Write down every factual discrepancy.
- Distinctive: line 48
Start with what you control, because it's free and it's the reference other sources copy from.
- Distinctive: line 74
Update the description on all of them to match the canonical paragraph.
- Distinctive: line 98
Update every owned surface on the same day.
- Very specific: line 100
Keep sameAs pointing at the new profiles, and keep the old profile pages live with a clear "formerly known as" note rather than deleting …
- Distinctive: line 102
Update every third-party listing, starting with LinkedIn and Crunchbase.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Entity and Brand Consistency
Search engines and language models both work with entities rather than strings. Before anything can rank or be cited for a brand, the system has to decide what that brand is, what category it belongs to, and which mentions across the web refer to it.
When the web describes a company inconsistently, that resolution fails or resolves wrong. The symptom is familiar: an assistant describes your product as something adjacent, attributes a competitor's feature to you, cites a three-year-old positioning line, or confuses you with a similarly named company in another industry.
None of that is fixed by writing more content. It's fixed by making every source agree.
Step 1: Audit what the web currently says
Do this before changing anything, and do it in a clean browser session with no personalisation.
- Search the brand name. What's on page one? What does the knowledge panel say, if there is one? What autocompletes after the name?
- Ask five assistants — ChatGPT, Claude, Perplexity, Gemini, Copilot — "what is [brand]" and "who makes [product]". Record the answers verbatim.
- Search the brand name with the category and see whether you appear at all.
- Search the brand name plus a competitor's name to see how you're positioned relative to them.
- Check for collisions. Is there another company, a person, a product or a common word with the same name? That's the disambiguation problem, and it changes the strategy.
Write down every factual discrepancy. Those are the work items, and they're usually specific: an old tagline, a former product name, an outdated founder list, a category label that stopped being accurate two pivots ago.
Step 2: Write the canonical description
One paragraph, one sentence, and a fact block. Everything downstream copies from here.
NAME: Exact legal and trading name, with capitalisation
CATEGORY: The category, in words a stranger uses
ONE-LINER: [Name] is a [category] that [does what] for [whom].
PARAGRAPH: 3-4 sentences. What it does, who for, what's distinct, founded when.
FOUNDED: Year
FOUNDERS: Full names
LOCATION: City, country
WEBSITE: Canonical URL, one form, with or without www — decide
LOGO: Canonical file, one versionThe one-liner is the load-bearing part. It's what gets quoted, and if every source says roughly the same sentence, that sentence becomes the answer. If every source says something different, the model averages them into mush or picks the loudest.
Be plain. "An AI-native SEO and GEO platform" resolves. "A next-generation growth intelligence layer" doesn't resolve to anything, because it isn't a category anyone recognises.
Step 3: Make the owned surfaces agree
Start with what you control, because it's free and it's the reference other sources copy from.
Organizationschema on every page, defined once with an@idand referenced. Name, URL, logo, description, founding date, founders, address, andsameAs. Seeschema-markup.sameAsis the key mechanism. It's an explicit statement that this entity is the same as the one at these other URLs. List every official profile: LinkedIn, GitHub, X, YouTube, Crunchbase, App Store, package registries, Wikidata if present.- The about page. Real, substantial, with the founding story, the team, the location, the actual facts. Thin about pages are a genuine handicap for entity resolution.
- One name form everywhere. Not "Example", "Example Inc.", "example.io" and "Example App" depending on the page.
- Consistent title tag suffix across the site.
- A logo people can find, in a consistent form, at a stable URL.
Step 4: Make the off-site surfaces agree
This is the work, and it's tedious rather than difficult.
| Surface | Why it matters |
| LinkedIn company page | Heavily weighted, widely syndicated, frequently outdated |
| Crunchbase | Feeds many aggregators and datasets |
| Wikidata | Structured, machine-readable, feeds knowledge graphs |
| GitHub organization | For technical products, a strong corroborating source |
| App Store / Play Store | Canonical for app products |
| Review platforms (G2, Capterra, Trustpilot, category-specific) | Frequently the description a model quotes |
| Your own docs and changelog | Often the most current and most cited technical source |
| Press coverage and podcast bios | Whatever you sent them is now permanent |
| Conference and speaker bios | Same |
| Employee LinkedIn headlines | Collectively describe the company |
Update the description on all of them to match the canonical paragraph. Then keep a list, because a rebrand means doing this again and the list is what makes it a day rather than a month.
Step 5: Wikidata and Wikipedia
Wikidata is a structured, openly editable knowledge base that feeds knowledge graphs and is heavily represented in training data. Creating an item for a company requires the entity to be notable enough to have references, but the bar is much lower than Wikipedia's. If your company has press coverage, funding announcements or an established product, an item with accurate properties and real references is legitimate and useful.
Wikipedia is different. Do not create or edit an article about your own company. Conflict-of-interest editing is against policy, it gets reverted, and it can result in the article being deleted or the company being flagged. If the company is genuinely notable, someone else will write it. If it isn't, no amount of trying will make it stick.
Step 6: Corroboration
Consistency across sources you control gets you a coherent story. What makes a model confident in that story is independent sources saying the same thing.
- Press and industry coverage describing the company in the same category
- Genuine community discussion where the product is mentioned in context
- Documentation and integrations on partner sites
- Review platform presence with real reviews
- Conference talks, podcasts, open-source contributions under the brand
The thing not to do is manufacture this. Seeding forum mentions, buying listicle placements at scale and generating fake reviews are all recognised patterns, spam systems target them specifically, and a model trained on the wider web sees the inconsistency between the manufactured mentions and everything else.
Rebrands and name changes
The highest-risk moment for entity resolution, and the one most often handled as a design project.
- Update every owned surface on the same day.
- Redirect the old domain at URL level, permanently. See
redirect-migration-plan. - Keep
sameAspointing at the new profiles, and keep the old profile pages live with a clear "formerly known as" note rather than deleting them. - Publish an announcement page explaining the change and keep it indefinitely. It's the document that lets a system connect the two names.
- Update every third-party listing, starting with LinkedIn and Crunchbase.
- Expect models to use the old name for a long time. Training data has a lag and there's nothing to do about it except be consistent everywhere from now on.
Measuring
Re-run the step 1 audit monthly and diff the answers. That's the whole measurement, and it's free for a single brand.
Doing it across five engines, multiple prompts and competitor comparisons every month is where it stops being practical by hand. Keupera runs it continuously through AI Brand Radar — visibility, position, sentiment and citations across ChatGPT, Perplexity, Google AI, Claude, Grok and Codex, benchmarked against competitors — over MCP:
claude mcp add --transport http keupera https://mcp.keupera.com/mcp -s userTrack two things over time: whether the description assistants give matches the canonical one-liner, and whether the brand appears at all for the category question. The second is the harder problem and the more valuable one.
Related skills
ai-visibility-audit, schema-markup, local-seo, eeat-author-pages, link-building-outreach, redirect-migration-plan
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

