agentleFS
keuperakeupera/seo-skills/skills/entity-brand-consistency/SKILL.md

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.

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
  1. Distinctive:

    Search engines and language models both work with entities rather than strings.

    line 8
  2. Distinctive:

    Do this before changing anything, and do it in a clean browser session with no personalisation.

    line 16
  3. Distinctive:

    Write down every factual discrepancy.

    line 24
  4. Distinctive:

    Start with what you control, because it's free and it's the reference other sources copy from.

    line 48
  5. Distinctive:

    Update the description on all of them to match the canonical paragraph.

    line 74
  6. Distinctive:

    Update every owned surface on the same day.

    line 98
  7. Very specific:

    Keep sameAs pointing at the new profiles, and keep the old profile pages live with a clear "formerly known as" note rather than deleting …

    line 100
  8. Distinctive:

    Update every third-party listing, starting with LinkedIn and Crunchbase.

    line 102

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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.

  1. Search the brand name. What's on page one? What does the knowledge panel say, if there is one? What autocompletes after the name?
  2. Ask five assistants — ChatGPT, Claude, Perplexity, Gemini, Copilot — "what is [brand]" and "who makes [product]". Record the answers verbatim.
  3. Search the brand name with the category and see whether you appear at all.
  4. Search the brand name plus a competitor's name to see how you're positioned relative to them.
  5. 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 version

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

  • Organization schema on every page, defined once with an @id and referenced. Name, URL, logo, description, founding date, founders, address, and sameAs. See schema-markup.
  • sameAs is 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.

SurfaceWhy it matters
LinkedIn company pageHeavily weighted, widely syndicated, frequently outdated
CrunchbaseFeeds many aggregators and datasets
WikidataStructured, machine-readable, feeds knowledge graphs
GitHub organizationFor technical products, a strong corroborating source
App Store / Play StoreCanonical for app products
Review platforms (G2, Capterra, Trustpilot, category-specific)Frequently the description a model quotes
Your own docs and changelogOften the most current and most cited technical source
Press coverage and podcast biosWhatever you sent them is now permanent
Conference and speaker biosSame
Employee LinkedIn headlinesCollectively 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.

  1. Update every owned surface on the same day.
  2. Redirect the old domain at URL level, permanently. See redirect-migration-plan.
  3. Keep sameAs pointing at the new profiles, and keep the old profile pages live with a clear "formerly known as" note rather than deleting them.
  4. Publish an announcement page explaining the change and keep it indefinitely. It's the document that lets a system connect the two names.
  5. Update every third-party listing, starting with LinkedIn and Crunchbase.
  6. 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 user

Track 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

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.