update-entities
How to add or remove domains from an entity (company/organization) in Tracker Radar. Use when modifying domain-to-entity mappings.
Source facts
- Repository
- duckduckgo/tracker-radar
- Last source activity
- March 4, 2026 at 21:37
- Detected SKILL.md language
- English
- Stars
- 1,738
- Forks
- 276
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- update-entities
- description
- How to add or remove domains from an entity (company/organization) in Tracker Radar. Use when modifying domain-to-entity mappings.
# 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
View on GitHub