Skip to main content

Entity Clarity Audit

Identify the brands, people, services, and locations on your page — and whether AI can recognize each one

What This Prompt Does

AI systems build answers around entities — brands, people, products, places. If your page mentions entities without enough context, the AI can't connect the dots and can't mention you. This prompt extracts every entity on the page, judges whether each is clearly identified, and prescribes fixes for the vague ones.

When to Use It

  • Your brand name appears on the page but AI summaries leave it out
  • Product names or people are mentioned only once without context
  • Service areas or locations feel implied rather than stated
  • You're preparing a page for an About or company profile refresh

The Prompt Template

Act as an entity optimization specialist.

Your goal is to identify the important entities on this page and determine whether they are explained clearly enough for AI systems to understand.

Context:
- Page text: [PASTE PAGE CONTENT]
- Business type: [BUSINESS TYPE]
- Topic: [TOPIC]

Task:
Identify:
1. the main entities on the page
2. which entities are clearly explained
3. which entities are vague or missing context
4. what should be added to make the entities clearer

Process:
1. Read the page.
2. Extract the important entities.
3. Review whether each entity is clearly identified and described.
4. Recommend improvements for weak or ambiguous entities.

Constraints:
- Use simple language.
- Focus on clarity, not technical jargon.
- Do not invent entities that are not supported by the page.
- Keep explanations short.
- Favor clearer facts, direct answers, and useful specifics over polished marketing language.

Output format:
Return a table with these columns:
- Entity
- Type
- Status: Clear or Unclear
- Problem
- Recommended Fix

How the Prompt Is Structured

1

Extract, Then Evaluate

The Process section separates extraction from evaluation. Getting the full entity list first ensures nothing gets skipped during the clarity check.

2

Binary Clear/Unclear Status

Status is binary on purpose. "Somewhat clear" tells you nothing. Forcing Clear or Unclear makes the output directly filterable — you can sort to the unclear rows and fix those first.

3

"Do Not Invent Entities"

Without the guardrail, AI tends to hallucinate plausible entities that don't actually exist on the page. The constraint keeps the output grounded in what the page really says.

4

Fix, Not Rewrite

Each row ends with a "Recommended Fix." Fixes are typically a single sentence of added context — not a rewrite of the surrounding paragraph.

Example Output

Entity Type Status Problem Fix
ABC Plumbing Brand Clear
Bozeman Location Unclear City is mentioned once but never stated as primary service area. Add "serving Bozeman and Gallatin County, Montana" near the top.
Mike Johnson Person Unclear Name appears in a quote but role is never stated. Introduce as "Mike Johnson, owner and master plumber since 2014."
Emergency Plumbing Service Clear

Tips for Better Results

Introduce Every Entity Once

Every brand, person, or product should have a short introduction the first time it appears. "ABC Plumbing, a licensed emergency service in Bozeman."

Link External Entities

If you mention a city, certifying body, or tool, link to its Wikipedia or official page. This gives AI systems a reliable reference point.

Chain With Schema

After fixing entity clarity, run the GEO Structured Data prompt to codify those entities in JSON-LD — double the effect.

Watch for Implicit Entities

Words like "our team" or "the service" refer to entities without naming them. These are the most common unclear entities on any page.

Make Every Entity Recognizable

We audit and rewrite entity references so AI systems can accurately describe your business, people, and offerings.