aiskillstore/marketplace / skills/aaron-he-zhu/entity-optimizer
entity-optimizer
VerifiedUse when the user asks to "optimize entity presence", reconcile an entity identity, or update canonical Knowledge Graph facts; audits and maintains machine-facing identity, sameAs, schema, disambiguation, and AI-recognition evidence through the entities registry. Not for page-level AI-citation readiness - use geo-content-optimizer; not for human-facing brand canon - use narrative-registry. 实体优化/知识图谱
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.8 KB |
| references/entity-signal-checklist.md | markdown | 6.4 KB |
| references/entity-type-reference.md | markdown | 1.8 KB |
| references/example-audit-report.md | markdown | 3.9 KB |
| references/knowledge-graph-guide.md | markdown | 2.4 KB |
| references/knowledge-panel-wikidata-guide.md | markdown | 3.2 KB |
| skill-report.json | config | 37.3 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-12T12:20:07.333Z",
"slug": "aaron-he-zhu-entity-optimizer",
"source_url": "https://github.com/aaron-he-zhu/aaron-marketing-skills/tree/main/protocol/entity-optimizer",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "17151313ea6819588145577a7c61f452cad3bbd271a1b5975d8375aa16224f35",
"tree_hash": "c30e634d87e12c57125f0c249d7d013ed0dd7b95dcc6e607eb9d92594ae4aa9d",
"provenance": {
"model_effective": "codex",
"fallback_chain": [
{
"agent": "codex",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "entity-optimizer",
"description": "Audit and maintain canonical entity identity, Knowledge Graph facts, sameAs links, schema types, disambiguation evidence, and AI recognition signals.",
"summary": "Reconcile verifiable entity facts and recognition signals through an authorized registry workflow.",
"icon": "📦",
"version": "13.0.3",
"author": "aaron-he-zhu",
"license": "Apache-2.0",
"category": "research",
"tags": [
"entity-optimization",
"knowledge-graph",
"wikidata",
"schema-org",
"ai-recognition"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"filesystem",
"external_commands",
"network"
]
},
"security_audit": {
"risk_level": "safe",
"is_blocked": false,
"safe_to_publish": true,
"analysis_status": "ok",
"summary": "All 36 static findings are false positives caused by Markdown formatting, documentation links, metadata URLs, or bounded commands with fixed executables and quoted arguments. No prompt injection, credential exposure, unsafe dynamic execution, or malicious data-handling intent was found.",
"remediation": [],
"risk_factor_evidence": [
{
"factor": "filesystem",
"evidence": [
{
"file": "references/entity-signal-checklist.md",
"line_start": 3,
"line_end": 3
},
{
"file": "SKILL.md",
"line_start": 38,
"line_end": 38
},
{
"file": "SKILL.md",
"line_start": 39,
"line_end": 39
},
{
"file": "SKILL.md",
"line_start": 44,
"line_end": 44
},
{
"file": "SKILL.md",
"line_start": 67,
"line_end": 67
},
{
"file": "SKILL.md",
"line_start": 87,
"line_end": 87
},
{
"file": "SKILL.md",
"line_start": 88,
"line_end": 88
},
{
"file": "SKILL.md",
"line_start": 92,
"line_end": 92
},
{
"file": "SKILL.md",
"line_start": 96,
"line_end": 96
},
{
"file": "SKILL.md",
"line_start": 97,
"line_end": 97
},
{
"file": "SKILL.md",
"line_start": 98,
"line_end": 98
},
{
"file": "SKILL.md",
"line_start": 99,
"line_end": 99
},
{
"file": "SKILL.md",
"line_start": 100,
"line_end": 100
},
{
"file": "SKILL.md",
"line_start": 67,
"line_end": 67
}
]
},
{
"factor": "external_commands",
"evidence": [
{
"file": "SKILL.md",
"line_start": 22,
"line_end": 27
},
{
"file": "SKILL.md",
"line_start": 27,
"line_end": 31
},
{
"file": "SKILL.md",
"line_start": 31,
"line_end": 31
},
{
"file": "SKILL.md",
"line_start": 33,
"line_end": 33
},
{
"file": "SKILL.md",
"line_start": 40,
"line_end": 40
},
{
"file": "SKILL.md",
"line_start": 50,
"line_end": 55
},
{
"file": "SKILL.md",
"line_start": 55,
"line_end": 67
},
{
"file": "SKILL.md",
"line_start": 67,
"line_end": 69
},
{
"file": "SKILL.md",
"line_start": 69,
"line_end": 72
},
{
"file": "SKILL.md",
"line_start": 72,
"line_end": 72
},
{
"file": "SKILL.md",
"line_start": 73,
"line_end": 73
},
{
"file": "SKILL.md",
"line_start": 74,
"line_end": 75
},
{
"file": "SKILL.md",
"line_start": 75,
"line_end": 77
},
{
"file": "SKILL.md",
"line_start": 77,
"line_end": 77
},
{
"file": "SKILL.md",
"line_start": 67,
"line_end": 67
},
{
"file": "SKILL.md",
"line_start": 67,
"line_end": 67
}
]
},
{
"factor": "network",
"evidence": [
{
"file": "SKILL.md",
"line_start": 10,
"line_end": 10
},
{
"file": "SKILL.md",
"line_start": 13,
"line_end": 13
}
]
}
],
"static_findings": [
{
"id": "filesystem:references/entity-signal-checklist.md:3:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "references/entity-signal-checklist.md",
"line_start": 3,
"line_end": 3,
"snippet": "> Part of [entity-optimizer](../SKILL.md). See also: [knowledge-graph-guide.md](knowledge-graph-guid"
},
{
"id": "blocker:references/entity-signal-checklist.md:14:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/entity-signal-checklist.md",
"line_start": 14,
"line_end": 14,
"snippet": "| 3 | Consistent @id across all pages | Same @id on every page |"
},
{
"id": "blocker:references/entity-type-reference.md:20:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/entity-type-reference.md",
"line_start": 20,
"line_end": 20,
"snippet": "| **Name collision with similar entity** | Geographic, industry, or product qualifiers; ensure Schem"
},
{
"id": "blocker:references/example-audit-report.md:57:network-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "Network reconnaissance",
"file": "references/example-audit-report.md",
"line_start": 57,
"line_end": 57,
"snippet": "- **CORE-EEAT**: A07 (Knowledge Graph Presence) scored Fail, A08 (Entity Consistency) scored Pass --"
},
{
"id": "external_commands:SKILL.md:22:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 22,
"line_end": 27,
"snippet": "```text"
},
{
"id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 27,
"line_end": 31,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:31:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 31,
"line_end": 31,
"snippet": "**Unit:** one stable, non-PII entity aggregate ID. **Reads:** `memory/events/entities.ndjson`, `memo"
},
{
"id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 33,
"line_end": 33,
"snippet": "Only a host-capability `entity-optimizer` principal may accept/reject proposals or upsert/transition"
},
{
"id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 40,
"line_end": 40,
"snippet": "- Entity descriptions may render Narrative canon but must carry `narrative_canon_id`, `narrative_can"
},
{
"id": "external_commands:SKILL.md:50:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 50,
"line_end": 55,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:55:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 55,
"line_end": 67,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:67:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 67,
"line_end": 69,
"snippet": "1. Read [registry-event-protocol.md](../../references/registry-event-protocol.md), [runtime-invocati"
},
{
"id": "external_commands:SKILL.md:69:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 69,
"line_end": 72,
"snippet": "3. Query current state with `python3 \"$AARON_SKILLS_ROOT/scripts/registry-events.py\" get entities <a"
},
{
"id": "external_commands:SKILL.md:72:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 72,
"line_end": 72,
"snippet": "6. Review pending `propose` events in offset order. A host-capability principal invokes `owner-appen"
},
{
"id": "external_commands:SKILL.md:73:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 73,
"line_end": 73,
"snippet": "7. For owner-authored canonical changes, a host-capability principal invokes `owner-append` with an "
},
{
"id": "external_commands:SKILL.md:74:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 74,
"line_end": 75,
"snippet": "8. Regenerate `memory/entities/<aggregate-id>.md` from accepted projection state if a human view is "
},
{
"id": "external_commands:SKILL.md:75:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 75,
"line_end": 77,
"snippet": "9. Run `verify entities`. Report accepted/rejected proposal IDs, current revision, confidence limits"
},
{
"id": "external_commands:SKILL.md:77:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 77,
"line_end": 77,
"snippet": "Never edit `memory/events/entities.ndjson` or `memory/projections/entities.json` by hand. Never writ"
},
{
"id": "external_commands:SKILL.md:67:shell-command-substitution",
"category": "external_commands",
"severity": "medium",
"pattern": "Shell command substitution",
"file": "SKILL.md",
"line_start": 67,
"line_end": 67,
"snippet": "1. Read [registry-event-protocol.md](../../references/registry-event-protocol.md), [runtime-invocati"
},
{
"id": "external_commands:SKILL.md:67:template-literal-with-command-substitution",
"category": "external_commands",
"severity": "medium",
"pattern": "Template literal with command substitution",
"file": "SKILL.md",
"line_start": 67,
"line_end": 67,
"snippet": "1. Read [registry-event-protocol.md](../../references/registry-event-protocol.md), [runtime-invocati"
},
{
"id": "network:SKILL.md:10:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "SKILL.md",
"line_start": 10,
"line_end": 10,
"snippet": "homepage: \"https://github.com/aaron-he-zhu/aaron-marketing-skills\""
},
{
"id": "network:SKILL.md:13:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "SKILL.md",
"line_start": 13,
"line_end": 13,
"snippet": "metadata: {\"author\": \"aaron-he-zhu\", \"version\": \"17.0.0\", \"discipline\": \"protocol\", \"phase\": \"protoc"
},
{
"id": "filesystem:SKILL.md:38:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 38,
"line_end": 38,
"snippet": "- [narrative-registry](../narrative-registry/SKILL.md) owns human-facing canon: positioning, message"
},
{
"id": "filesystem:SKILL.md:39:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 39,
"line_end": 39,
"snippet": "- [offer-claims-registry](../offer-claims-registry/SKILL.md) owns claim substantiation."
},
{
"id": "filesystem:SKILL.md:44:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 44,
"line_end": 44,
"snippet": "Use [skill-contract.md](../../references/skill-contract.md). Include changed event IDs, latest proje"
},
{
"id": "filesystem:SKILL.md:67:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 67,
"line_end": 67,
"snippet": "1. Read [registry-event-protocol.md](../../references/registry-event-protocol.md), [runtime-invocati"
},
{
"id": "filesystem:SKILL.md:87:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 87,
"line_end": 87,
"snippet": "- [Registry event protocol](../../references/registry-event-protocol.md)"
},
{
"id": "filesystem:SKILL.md:88:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 88,
"line_end": 88,
"snippet": "- [Entity-GEO handoff schema](../../references/entity-geo-handoff-schema.md)"
},
{
"id": "filesystem:SKILL.md:92:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 92,
"line_end": 92,
"snippet": "- [State model](../../references/state-model.md)"
},
{
"id": "filesystem:SKILL.md:96:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 96,
"line_end": 96,
"snippet": "- **Schema implementation:** [serp-markup-builder](../../seo-geo/build/serp-markup-builder/SKILL.md)"
},
{
"id": "filesystem:SKILL.md:97:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 97,
"line_end": 97,
"snippet": "- **AI-citable page work:** [geo-content-optimizer](../../seo-geo/build/geo-content-optimizer/SKILL."
},
{
"id": "filesystem:SKILL.md:98:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 98,
"line_end": 98,
"snippet": "- **New page:** [content-writer](../../seo-geo/build/content-writer/SKILL.md)"
},
{
"id": "filesystem:SKILL.md:99:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 99,
"line_end": 99,
"snippet": "- **Canon conflict:** [narrative-registry](../narrative-registry/SKILL.md)"
},
{
"id": "filesystem:SKILL.md:100:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 100,
"line_end": 100,
"snippet": "- **Archive/erase:** [memory-management](../memory-management/SKILL.md)"
},
{
"id": "filesystem:SKILL.md:67:standard-device-file-access",
"category": "filesystem",
"severity": "low",
"pattern": "Standard device file access",
"file": "SKILL.md",
"line_start": 67,
"line_end": 67,
"snippet": "1. Read [registry-event-protocol.md](../../references/registry-event-protocol.md), [runtime-invocati"
},
{
"id": "blocker:SKILL.md:6:network-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "Network reconnaissance",
"file": "SKILL.md",
"line_start": 6,
"line_end": 6,
"snippet": "description: 'Use when the user asks to \"optimize entity presence\", reconcile an entity identity, or"
}
],
"finding_verdicts": [
{
"id": "filesystem:references/entity-signal-checklist.md:3:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The sequence is a relative Markdown link to the parent SKILL.md file, not a user-controlled filesystem operation."
},
{
"id": "blocker:references/entity-signal-checklist.md:14:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The line defines a consistency check for schema.org @id values across pages and performs no system reconnaissance."
},
{
"id": "blocker:references/entity-type-reference.md:20:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The line recommends unique schema identifiers for entity disambiguation and contains no host or system discovery instruction."
},
{
"id": "blocker:references/example-audit-report.md:57:network-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The line reports example SEO audit scores and does not enumerate, probe, or scan network resources."
},
{
"id": "external_commands:SKILL.md:22:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The detected backticks open a fenced text example and are Markdown formatting, not Ruby or shell execution."
},
{
"id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The detected backticks close a fenced text example and do not execute a command."
},
{
"id": "external_commands:SKILL.md:31:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Backticks format registry paths and command names in prose; there is no Ruby expression or shell backtick substitution."
},
{
"id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Backticks identify principals and event operations in Markdown and do not create executable shell syntax."
},
{
"id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Backticks delimit entity field names in documentation; no command is invoked."
},
{
"id": "external_commands:SKILL.md:50:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is a Bash code-fence marker; the documented helper commands use fixed Python scripts and quoted positional arguments."
},
{
"id": "external_commands:SKILL.md:55:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The backticks close a Bash documentation fence and are not executable shell backticks."
},
{
"id": "external_commands:SKILL.md:67:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks are Markdown spans around a bounded environment assignment and do not represent Ruby or legacy shell backtick execution."
},
{
"id": "external_commands:SKILL.md:69:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The command is presented in an inline Markdown span with a fixed script path and quoted root variable, not shell backtick execution."
},
{
"id": "external_commands:SKILL.md:72:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Backticks format registry operation names and fields in prose; they do not execute those values."
},
{
"id": "external_commands:SKILL.md:73:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The line uses Markdown backticks for operation and field names and explicitly excludes capability values from requests and logs."
},
{
"id": "external_commands:SKILL.md:74:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The detected backticks format a generated view path and do not perform command substitution."
},
{
"id": "external_commands:SKILL.md:75:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The backticks identify a fixed verification command in documentation, not a Ruby or shell backtick expression."
},
{
"id": "external_commands:SKILL.md:77:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "Backticks format protected registry file paths in a prohibition against manual edits."
},
{
"id": "external_commands:SKILL.md:67:shell-command-substitution",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The substitution runs only the fixed git rev-parse --show-toplevel command to locate the repository root, with no user-controlled command text."
},
{
"id": "external_commands:SKILL.md:67:template-literal-with-command-substitution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The text is a Markdown code span containing shell syntax, not a JavaScript template literal or dynamically evaluated template."
},
{
"id": "network:SKILL.md:10:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The URL is repository homepage metadata and is not used as a network request destination."
},
{
"id": "network:SKILL.md:13:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The URL appears only in OpenClaw metadata and does not trigger a request or transmit data."
},
{
"id": "filesystem:SKILL.md:38:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The sequence is a static relative Markdown link to a sibling skill, not a path built from untrusted input."
},
{
"id": "filesystem:SKILL.md:39:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The sequence is a static documentation link to a sibling registry skill and performs no filesystem traversal."
},
{
"id": "filesystem:SKILL.md:44:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The sequence is a fixed relative link to shared skill-contract documentation, with no user-controlled path."
},
{
"id": "filesystem:SKILL.md:67:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The sequences are fixed relative links to shared protocol documents and are not used to escape a filesystem boundary."
},
{
"id": "filesystem:SKILL.md:87:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The sequence is a static reference link to bundled protocol documentation."
},
{
"id": "filesystem:SKILL.md:88:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The sequence is a static reference link to the entity handoff schema."
},
{
"id": "filesystem:SKILL.md:92:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The sequence is a static reference link to the documented state model."
},
{
"id": "filesystem:SKILL.md:96:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The sequence is a fixed Markdown link to a related schema implementation skill."
},
{
"id": "filesystem:SKILL.md:97:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The sequence is a fixed Markdown link to a related content optimization skill."
},
{
"id": "filesystem:SKILL.md:98:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The sequence is a fixed Markdown link to a related content authoring skill."
},
{
"id": "filesystem:SKILL.md:99:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The sequence is a static relative link to the sibling narrative registry skill."
},
{
"id": "filesystem:SKILL.md:100:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The sequence is a static relative link to the sibling memory management skill."
},
{
"id": "filesystem:SKILL.md:67:standard-device-file-access",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The only device path is /dev/null used for standard error suppression on a fixed git command, not sensitive device access."
},
{
"id": "blocker:SKILL.md:6:network-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The description mentions AI-system disambiguation as the skill purpose and contains no network discovery or probing instruction."
}
],
"semantic_findings": [],
"critical_findings": [],
"high_findings": [],
"medium_findings": [],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 6,
"total_lines": 447,
"audit_model": "codex",
"audited_at": "2026-07-12T12:20:07.333Z",
"agent_auto_install_policy": "allowed",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Optimize Knowledge Graph Entity Presence",
"value_statement": "Inconsistent entity facts weaken search and AI recognition. This skill audits evidence, resolves identity conflicts, and records authorized canonical updates with provenance.",
"seo_keywords": [
"entity optimization",
"Knowledge Graph audit",
"Wikidata optimization",
"schema.org identity",
"sameAs links",
"entity disambiguation",
"AI recognition audit",
"Claude",
"Codex",
"Claude Code"
],
"actual_capabilities": [
"Audits structured data, knowledge bases, identity consistency, corroboration, and AI recognition signals.",
"Reconciles duplicate or ambiguous entities using verified cross-links and user confirmation.",
"Tracks canonical entity types, aliases, domains, QIDs, sameAs links, and disambiguation evidence.",
"Distinguishes unknown observations from failed or partial checks.",
"Reviews proposals and records authorized accept, reject, or upsert events through the registry runtime.",
"Produces prioritized actions with sources, dates, confidence limits, revisions, and unresolved conflicts."
],
"limitations": [
"Requires the verified registry runtime to persist canonical changes.",
"Does not create page copy, implement schema markup, or define brand positioning.",
"Cannot guarantee a Knowledge Panel, Wikipedia eligibility, search ranking, or AI recognition.",
"Optional recognition checks may be unavailable and must remain unknown."
],
"use_cases": [
{
"title": "Audit an organization",
"description": "Assess machine-facing identity signals and prioritize evidence-backed corrections across owned and authoritative sources.",
"target_user": "SEO and GEO specialists"
},
{
"title": "Reconcile registry proposals",
"description": "Review proposed facts, resolve duplicate identifiers, and preserve conflicting evidence before authorized acceptance.",
"target_user": "Knowledge management teams"
},
{
"title": "Diagnose AI confusion",
"description": "Compare entity descriptions and associations to identify why AI systems confuse similar organizations or products.",
"target_user": "Brand and product teams"
}
],
"prompt_templates": [
{
"title": "Run a basic entity audit",
"prompt": "Audit entity recognition for [entity name]. Use [official domain] and these verified profiles: [links]. Mark unavailable checks as unknown.",
"scenario": "Start with a known organization and a small set of verified sources."
},
{
"title": "Check identity consistency",
"prompt": "Compare the canonical name, type, domain, schema @id, QID, and sameAs links for [entity]. Report conflicts and missing evidence.",
"scenario": "Find inconsistent identifiers across owned and external sources."
},
{
"title": "Resolve ambiguous entities",
"prompt": "Disambiguate [entity A] from [entity B]. Require verified cross-links, preserve conflicting evidence, and propose changes without writing them.",
"scenario": "Separate organizations, products, or people with similar names."
},
{
"title": "Adjudicate registry proposals",
"prompt": "Review pending proposals for [aggregate ID] in offset order. Validate provenance, revision expectations, authority, and downstream dependencies before recommending decisions.",
"scenario": "Perform an advanced governance review before authorized registry updates."
}
],
"output_examples": [
{
"input": "Audit Acme Analytics using its official domain and verified LinkedIn profile.",
"output": [
"Structured data: Partial. The organization type is present, but sameAs evidence is incomplete.",
"Knowledge bases: Unknown. No verified QID was supplied.",
"Priority action: Verify external identifiers before proposing a canonical update."
]
},
{
"input": "Explain why two products named Atlas are being confused.",
"output": "The records share a name but lack verified cross-links. Keep separate IDs and add domain, product category, and official profile evidence."
},
{
"input": "Review pending changes for entity-7f42.",
"output": [
"Proposal review: One fact has current evidence and matching revision context.",
"Open conflict: Two same-date sources disagree on the canonical domain.",
"Decision: Leave the conflicting proposal pending until the owner confirms the domain."
]
}
],
"best_practices": [
"Use primary sources, record observation dates, and preserve provenance for every factual claim.",
"Require verified cross-links or explicit confirmation before merging similar entities.",
"Ask before persistent writes and keep capability values out of prompts, files, and logs."
],
"anti_patterns": [
"Do not treat missing optional checks as failures or partial results.",
"Do not manufacture notability, citations, profiles, or evidence.",
"Do not edit canonical event streams or generated projections by hand."
],
"faq": [
{
"question": "What entity types can this skill audit?",
"answer": "It supports organizations, people, brands, products, creative works, events, places, publications, and concepts when reliable evidence exists."
},
{
"question": "Does it create Wikidata or Wikipedia pages?",
"answer": "No. It assesses eligibility and evidence, but any contribution must follow sourcing, neutrality, notability, and conflict-of-interest rules."
},
{
"question": "Can it guarantee a Knowledge Panel?",
"answer": "No. It can improve evidence quality and consistency, but search platforms control panel creation and display."
},
{
"question": "Will it update the canonical registry automatically?",
"answer": "No. Persistent changes require explicit authorization, a verified runtime, valid revisions, and the correct host capability."
},
{
"question": "How does it handle unavailable AI checks?",
"answer": "It records them as unknown. It does not convert unavailable observations into partial or failed results."
},
{
"question": "How does it protect personal information?",
"answer": "It requires a lawful basis, minimizes fields, uses pseudonymous IDs, excludes contact details, and respects prior erasure records."
}
]
},
"file_structure": [
{
"name": "references",
"type": "dir",
"path": "references",
"children": [
{
"name": "entity-signal-checklist.md",
"type": "file",
"path": "references/entity-signal-checklist.md",
"lines": 139
},
{
"name": "entity-type-reference.md",
"type": "file",
"path": "references/entity-type-reference.md",
"lines": 23
},
{
"name": "example-audit-report.md",
"type": "file",
"path": "references/example-audit-report.md",
"lines": 60
},
{
"name": "knowledge-graph-guide.md",
"type": "file",
"path": "references/knowledge-graph-guide.md",
"lines": 59
},
{
"name": "knowledge-panel-wikidata-guide.md",
"type": "file",
"path": "references/knowledge-panel-wikidata-guide.md",
"lines": 65
}
]
},
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 101
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |