Intelligence Vocabulary
Customer-facing Intelligence docs use one name per concept. A second name for the same thing is a regression.
When To Use
Load this skill before writing or editing prose a customer reads about CopilotKit Intelligence. That includes pages, snippets, nav titles, button labels, and image alt text under showcase/shell-docs.
Also load skills/intelligence-docs/SKILL.md when the change adds, renames, or removes an Intelligence page. That skill keeps the landing page in sync. This skill owns the words.
Do not load this skill to rename code. Identifiers, route slugs, env vars, API fields, and component names stay as they are, even when a Stop word appears inside them.
Procedures
Procedure 1: Apply the word list
- Read
references/words.md before writing or editing customer-facing Intelligence prose.
- Use the Use column for headings, nav titles, button labels, alt text, and body prose.
- Keep plan names as Developer, Team, Team Self-hosted, and Enterprise.
- If a fact already has a home in
references/words.md, link to that page. Do not explain the fact again under a second name.
- Write Inspector click steps with the labels the shipped controls render: Rich Threads and Automatic Learning.
Procedure 2: Check the change
- Search the added or edited prose for every phrase in the Stop column of
references/words.md.
- Keep a hit that the exception list in
references/words.md names.
- Rewrite every other hit to the Use word for that concept.
- Leave identifiers, slugs, env vars, API fields, and component names unchanged.
Decision Tree
- Customer-facing Intelligence prose, labels, or alt text: Procedure 1, then Procedure 2
- Page added, renamed, or removed: this skill for the words, and
skills/intelligence-docs/SKILL.md for the landing page
- The only edit is code, a slug, an env var, or an API field: stop. Do not rename it to match the word list
- The page does not mention Intelligence: stop
Red Flags
| Signal |
What it means |
Do instead |
| Two names for one concept on the same page |
The word list was skipped |
Procedure 2 |
| "managed" or "hosted" as the name of the CopilotKit-operated deployment |
The deployment name drifted |
Write cloud-hosted |
| A Stop word removed by renaming a component, slug, or env var |
The skill was applied to code |
Restore the identifier. Change only customer prose |
| Clerk, or a rollout cutoff, added to a customer page |
Internal implementation leaked |
Delete that sentence. Say what the customer does |
Error Handling
- A Stop phrase is inside an identifier: leave the identifier. Change the surrounding prose only when that prose uses the Stop word as a customer-facing name.
- A hit is on the exception list: keep it. Do not "fix" managed Channel, customer-managed, a hosted zone, a ticket id, or a plan name.
- The approved word and the visible product label disagree: use the label the shipped control renders for a click step. Record the conflict. Do not invent a third name.
- No home exists for a new fact: stop and name the missing page. Do not park the fact under a nearby page with a new synonym.
1---2name: intelligence-vocabulary3description: >4 Locks customer-facing CopilotKit Intelligence docs to one approved name per5 concept. Use when writing, editing, or reviewing Intelligence docs, nav6 labels, signup labels, or image alt text in showcase/shell-docs. Don't use7 for renaming code identifiers, route slugs, env vars, API fields, or8 component names, or for docs that do not mention Intelligence.9version: 1.0.010metadata:11 source: https://skillmd.com/skills/gabrielmoreira/intelligence-vocabulary12---1314# Intelligence Vocabulary1516Customer-facing Intelligence docs use one name per concept. A second name for the same thing is a regression.1718## When To Use1920Load this skill before writing or editing prose a customer reads about CopilotKit Intelligence. That includes pages, snippets, nav titles, button labels, and image alt text under `showcase/shell-docs`.2122Also load `skills/intelligence-docs/SKILL.md` when the change adds, renames, or removes an Intelligence page. That skill keeps the landing page in sync. This skill owns the words.2324Do not load this skill to rename code. Identifiers, route slugs, env vars, API fields, and component names stay as they are, even when a Stop word appears inside them.2526## Procedures2728### Procedure 1: Apply the word list29301. Read `references/words.md` before writing or editing customer-facing Intelligence prose.312. Use the **Use** column for headings, nav titles, button labels, alt text, and body prose.323. Keep plan names as Developer, Team, Team Self-hosted, and Enterprise.334. If a fact already has a home in `references/words.md`, link to that page. Do not explain the fact again under a second name.345. Write Inspector click steps with the labels the shipped controls render: **Rich Threads** and **Automatic Learning**.3536### Procedure 2: Check the change37381. Search the added or edited prose for every phrase in the **Stop** column of `references/words.md`.392. Keep a hit that the exception list in `references/words.md` names.403. Rewrite every other hit to the **Use** word for that concept.414. Leave identifiers, slugs, env vars, API fields, and component names unchanged.4243## Decision Tree4445- Customer-facing Intelligence prose, labels, or alt text: Procedure 1, then Procedure 246- Page added, renamed, or removed: this skill for the words, and `skills/intelligence-docs/SKILL.md` for the landing page47- The only edit is code, a slug, an env var, or an API field: stop. Do not rename it to match the word list48- The page does not mention Intelligence: stop4950## Red Flags5152| Signal | What it means | Do instead |53| ----------------------------------------------------------------------- | ------------------------------ | -------------------------------------------------- |54| Two names for one concept on the same page | The word list was skipped | Procedure 2 |55| "managed" or "hosted" as the name of the CopilotKit-operated deployment | The deployment name drifted | Write cloud-hosted |56| A Stop word removed by renaming a component, slug, or env var | The skill was applied to code | Restore the identifier. Change only customer prose |57| Clerk, or a rollout cutoff, added to a customer page | Internal implementation leaked | Delete that sentence. Say what the customer does |5859## Error Handling6061- **A Stop phrase is inside an identifier:** leave the identifier. Change the surrounding prose only when that prose uses the Stop word as a customer-facing name.62- **A hit is on the exception list:** keep it. Do not "fix" managed Channel, customer-managed, a hosted zone, a ticket id, or a plan name.63- **The approved word and the visible product label disagree:** use the label the shipped control renders for a click step. Record the conflict. Do not invent a third name.64- **No home exists for a new fact:** stop and name the missing page. Do not park the fact under a nearby page with a new synonym.