docs(docs/ai-coder/agents): describe skill chips in the / menu

Document the Commands group, the chip label, when the skill is read,
the not available error, and that typed /name text is sent as plain
text.
This commit is contained in:
Jaayden Halko
2026-10-15 19:08:51 +00:00
parent 0a26200d12
commit f79a56eea1
+8 -1
View File
@@ -277,10 +277,17 @@ Because stored skills are read again at each step, a change takes effect on the
For example, when an administrator turns off an organization skill or removes someone's access, the chat stops listing that skill on its next step.
The `/` menu in the chat composer lists skills in four groups: **Personal skills**, **Organization skills**, **Project skills**, and **Workspace skills**.
When you write a new message in an existing chat, a **Commands** group above them also lists the built-in `/compact` and `/clear` commands.
The **Project skills** group appears only in chats that belong to a project.
The **Organization skills** group shows the skills of the chat's organization that are turned on and that you can use.
For site owners, organization admins, and auditors, the group lists every organization skill that is turned on.
Choosing a skill from the `/` menu attaches it to your message, so the agent always loads that skill for the message instead of deciding whether to read it.
Choosing a skill from the `/` menu attaches it to your message as a chip, so the agent always loads that skill for the message instead of deciding whether to read it.
The chip shows the skill's qualified alias, such as `/project/triage`, even when the menu lists the skill by its bare name.
Coder reads the skill when you send the message, so a queued message keeps the version of the skill it was sent with.
If the skill is turned off, deleted, or no longer available to you at that point, Coder rejects the message with an error such as `Skill project/triage is not available.`
Remove the chip, or turn the skill back on, and send the message again.
Text such as `/triage` that you type without choosing it from the menu is sent as plain text, and the agent decides whether to read the skill.
### Turn a skill on or off