# Update Entities

> Update Entities is an Agent Skill for development published in the duckduckgo/tracker-radar repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

How to add or remove domains from an entity (company/organization) in Tracker Radar. Use when modifying domain-to-entity mappings.

- Skill name: `update-entities`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/duckduckgo/tracker-radar/blob/HEAD/.cursor/skills/update-entities/SKILL.md
- Repository: duckduckgo/tracker-radar (1,707 GitHub stars when collected)

## SKILL.md

# How to Update Entities

## Prerequisites

1. Clone the [tracker-radar-detector](https://github.com/duckduckgo/tracker-radar-detector) repo alongside this one and run `npm install`.
2. Update the tracker-radar-detector `config.json` so `trackerRadarRepoPath` points to your local clone of this repo (tracker-radar).

## Steps

### 1. Edit `build-data/generated/entity_map.json`

Find the target entity and add the new domain to its `properties` array in **alphabetical order**.

### 2. Run `npm run apply-entity-changes` in the tracker-radar-detector repo

This propagates changes to all dependent files:

| File | What changes |
|---|---|
| `build-data/generated/entity_map.json` | The source of truth you edited |
| `build-data/generated/domain_map.json` | Reverse mapping — one entry per domain with `entityName`, `aliases`, `displayName` |
| `entities/<Entity Name>.json` | The entity file gets the domain added to its `properties` array |

### 3. Verify

- **`entity_map.json`** — domain in the entity's `properties`, alphabetically sorted
- **`domain_map.json`** — new key for the domain with correct `entityName`, `aliases`, `displayName`
- **`entities/<Entity Name>.json`** — domain in `properties`, alphabetically sorted
- All three files are valid JSON
- Run `npm test` to validate schemas

---

Source: https://www.openparable.com/skill/development/update-entities (OpenParable). Cite the canonical URL above.
