entity-optimizer

An auditing and planning tool for making a person, company, product, or concept clearly identifiable to search engines and AI systems. It examines sources such as Google’s Knowledge Graph, Wikidata, and Wikipedia.

In plain words
What is it for?
Use it to review an entity’s online identity, map missing recognition signals, plan improvements, and create a consistent profile and handoff summary.
Why use it?
It helps find gaps or confusion in how an entity is represented online, which can make it harder for search engines and AI systems to identify or cite it.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/opencue/cuecards/entity-optimizer
Any agent
npx skills add opencue/cuecards --skill entity-optimizer
Clone the repo
git clone --depth 1 https://github.com/opencue/cuecards

Made for: Claude Code, Codex.

Per session 38 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,488 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00038 $0.03488
Opus 5 $0.00019 $0.01744
Sonnet 5 $0.00008 $0.00698
Haiku 4.5 $0.00004 $0.00349

Measured 2d ago against content hash 5a1160bbca28, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

entity-optimizer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/entity-optimizer/SKILL.md · 239 lines

How it starts

The opening of the file, as written. The whole thing — 239 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Entity Optimizer

Audits, builds, and maintains entity identity across search engines and AI systems. Entities — the people, organizations, products, and concepts that search engines and AI systems recognize as distinct things — are the foundation of how both Google and LLMs decide what a brand is and whether to cite it.

Why entities matter for SEO + GEO:

  • SEO: Google's Knowledge Graph powers Knowledge Panels, rich results, and entity-based ranking signals. A well-defined entity earns SERP real estate.
  • GEO: AI systems resolve queries to entities before generating answers. If an AI cannot identify an entity, it cannot cite it — no matter how good the content is.

What This Skill Does

Audits entity presence across Knowledge Graph, Wikidata, Wikipedia, and AI systems; maps all 6 signal categories (47 signals); produces a gap analysis, building plan, and disambiguation strategy.

Quick Start

Start with one of these prompts. Finish with a canonical entity profile and a handoff summary using the repository format in Skill Contract.

Entity Audit

Audit entity presence for [brand/person/organization]
How well do search engines and AI systems recognize [entity name]?

Build Entity Presence

Build entity presence for [new brand] in the [industry] space
Establish [person name] as a recognized expert in [topic]

Fix Entity Issues

My Knowledge Panel shows incorrect information — fix entity signals for [entity]
AI systems confuse [my entity] with [other entity] — help me disambiguate

Skill Contract

Expected output: an entity audit, a canonical entity profile, and a short handoff summary ready for memory/entities/.

  • Reads: the entity name, primary domain, known profiles, topic associations, and prior brand context from AGENTS.md and the shared State Model when available.
  • Writes: a user-facing entity report plus a reusable profile that can be stored under memory/entities/.
  • Promotes: canonical names, sameAs links, disambiguation notes, and entity gaps to memory/hot-cache.md, memory/entities/, and memory/open-loops.md.

Read the full file on GitHub · 239 lines

Files

What ships with it

5 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 239 lines · 38 tokens per session scan A 5a1160bbca28

Subscribe to this mod's changes

entity-optimizer is a skill published in the GitHub repository opencue/cuecards (5 stars, last pushed 2d ago), licensed MIT. It adds 38 tokens to every session and 3,488 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

aeo-optimization

AI Engine Optimization - semantic triples, page templates, content clusters for AI citations.

alinaqi/maggy · 20 tokens

draft-release-post

リリース告知のXポスト下書きを作成する.

dyoshikawa/rulesync · 19 tokens

build-in-public

Build in public isn't marketing. It's letting people watch you work. The best posts feel like you're narrating your thought process to a friend who's also a senior engineer. No hype sludge. No "I'm excited to announce." Just: here's what I built, here's why it matters, here's what I learned.

alinaqi/maggy · 0 tokens

memstack-content-email-sequence

Use this skill when the user says 'write email sequence', 'email sequence', 'drip campaign', 'email series', 'nurture sequence', 'onboarding emails', 'launch emails', or is creating a multi-email automated campaign. Do NOT use for newsletters or single marketing emails.

cwinvestments/memstack · 66 tokens

memstack-content-landing-page-copy

Use this skill when the user says 'write landing page', 'landing page copy', 'sales page', 'hero section', 'conversion copy', or is creating persuasive short-form copy for a product or service landing page. Do NOT use for blog posts or email sequences.

cwinvestments/memstack · 62 tokens

memstack-content-youtube-script

Use this skill when the user says 'YouTube script', 'video script', 'write script for YouTube', 'YouTube video outline', or is creating scripted content for a YouTube video with hooks, chapters, and CTAs. Do NOT use for TikTok/Reels short-form scripts or webinar presentations.

cwinvestments/memstack · 70 tokens