You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: rewrite Agent Skills for the two-tab surface; document the chat / picker
os/agent-settings/skills.md — the page described a flat list of skill
cards with an assignment toggle. Rewritten for what ships: Agent Skills
/ Available Skills tabs, Add to Agent + the Added chip, private ("Only
This Agent") skills and slug precedence, the Resources sub-tab
(reference/script text vs uploaded assets), featured skills being
read-only, the chat `/` picker, and the Base-Agent-only scope. Seven
screenshots.
os/chat-canvas/chat.md — the composer has a Skills chip and a `/` skill
picker; neither was documented. Added with a screenshot.
developer/applications/vibe.md — the Skills table listed 25 skills under
the old `/iblai-*` names; upstream has 70 under `/iblai-vibe-*`, so every
command in it was wrong. Replaced and grouped.
Source: https://github.com/iblai/vibe/tree/main/skills/iblai-vibe-agent-skills
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
3
+
4
4
5
5
## Overview
6
6
7
-
The Skills panel assigns reusable skills to an agent. The panel header reads: "Manage agent skill assignments for your mentor" (the UI's exact wording), and the helper text explains: "Skills are reusable capabilities you build once and assign to any agent. Create a skill, then toggle it on to give this agent that ability."
7
+
The Skills panel manages **Agent Skills** — reusable playbooks a Base Agent can discover and follow. A skill is a written instruction bundle (plus optional reference files) for one job, such as researching a topic on the web or reviewing code. The agent reads a skill only when it is relevant, so an agent can carry many capabilities without bloating every conversation.
8
8
9
-
Skills live at the organization level: you define a skill once (name, slug, description, version, and instruction text) and can then assign it to any number of agents. Each skill appears as a card with its name, a version badge (for example, v1.0.0), an assignment toggle, and an overflow ("...") menu for managing the skill itself.
9
+
The panel header reads: "Reusable playbooks this Base Agent can discover and follow." The panel is split into two tabs — **Agent Skills** (the set this agent carries, with enable/disable toggles) and **Available Skills** (the organization's full catalog, with one-click **Add to Agent**) — plus New/Edit Skill dialogs and a **Resources** file manager for attaching files to a skill.
10
+
11
+
Skills are managed independently of the Claw sandbox: no sandbox instance is required for the panel to work. In chat, users invoke a skill by typing `/` in the composer.
10
12
11
13
To reach this screen, open the **Edit Agent** modal, stay on the **Configurations** tab group, and select **Skills** in the left sidebar.
12
14
15
+
Agent Skills apply to **Base Agent** agents only. On other agent types the tab is not offered.
16
+
13
17
## Target Audience
14
18
15
19
**Administrator** | **Agent Builder**
16
20
17
21
## Panel Reference
18
22
23
+
#### Session behavior note
24
+
An info line at the top of the panel states: "Skills added or removed here apply to new chat sessions only. Edits to a skill's instructions apply immediately, including in conversations already in progress." Plan changes accordingly — attaching a skill mid-conversation will not affect that conversation.
25
+
19
26
#### New Skill
20
-
Opens the skill-creation dialog. **Name** and **Slug** are required; you can also provide a description, a version (defaults to 1.0.0), and the skill's instruction text — the behavior the skill adds when assigned to an agent. Newly created skills are enabled on creation, and a "Skill created" confirmation appears.
27
+
Opens the skill-creation dialog (see [New Skill dialog](#new-skill-dialog) below). Available from either tab.
28
+
29
+
#### Agent Skills tab
30
+
The agent's *effective* set: the skills assigned to it plus its own private skills, deduped by slug. Each row shows the skill's name, version, badges (category, Native, Featured, Private), and description, followed by an enable toggle and a kebab ("...") menu.
31
+
32
+
#### Available Skills tab
33
+
34
+
35
+
36
+
The organization's full skill catalog, paged 10 at a time. Rows show the same name/version/badges/description block. **Add to Agent** attaches a skill to this agent; rows already covered by the agent's set — attached, or shadowed by a private skill with the same slug — show a green **Added** chip instead. Another agent's private skills are not attachable.
37
+
38
+
#### Enable toggle
39
+
Turns a skill on or off for this agent. A skill is active only when both the skill itself and its assignment to this agent are enabled, and only enabled skills appear in the chat `/` picker.
40
+
41
+
#### Kebab ("...") menu
42
+
43
+
44
+
45
+
Per-row actions: **Remove from Agent** detaches the skill from this agent (shown for assigned skills); **Edit** opens the Edit Skill dialog; **Delete** removes the skill from the organization. Edit and Delete appear only for skills your organization owns — **Featured skills are read-only** and their edit and delete actions are hidden.
21
46
22
-
#### Skill cards
23
-
Each card lists a skill available in the organization, with its name and version (the screenshot shows **Web Research** v1.0.0 and **Image Creation** v1.0.0). The card's toggle controls the skill's assignment to this agent: on means the agent has the skill (Web Research in the screenshot), off means it does not (Image Creation).
47
+
#### New Skill dialog
24
48
25
-
#### Assignment toggle
26
-
Toggling on creates a skill assignment for this agent; toggling off removes it. Because skills are shared, toggling here only affects this agent's assignment — the skill itself remains available to other agents.
49
+
27
50
28
-
#### Overflow ("...") menu
29
-
Actions for the underlying skill, including editing its definition (name, slug, description, version, instruction) and deleting it. Editing or deleting a skill affects it organization-wide, not just for this agent; deleting shows a "Skill deleted" confirmation.
51
+
-**Only This Agent** — "Private skills are available to this agent only and take precedence over platform skills with the same slug." Leave it off to create a skill the whole organization can use.
52
+
-**Name** and **Slug** are required. The slug is what users type after `/` in chat.
53
+
-**Version** defaults to `1.0.0`; **Category** (for example web, code, data) and **Description** are optional.
54
+
-**Instruction** is the playbook the agent follows when the skill is used. Edits to it apply immediately, including in conversations already in progress.
55
+
56
+
#### Edit Skill dialog — General
57
+
58
+
59
+
60
+
The same fields as New Skill, pre-filled, under a **General** / **Resources** tab pair. **Save** writes the change organization-wide, not just for this agent.
61
+
62
+
#### Edit Skill dialog — Resources
63
+
64
+
65
+
66
+
Optional files the agent can use with the skill, attachable after the skill is created. **Reference** and **Script** resources are text files (filename plus content); **Asset** resources are uploaded binary files. Each row shows the filename and a type chip, with a kebab menu offering **Download** (assets), **Edit** (text files), and **Delete**.
67
+
68
+
#### Chat `/` skill picker
69
+
70
+
71
+
72
+
In chat, typing `/` as the first word of a message opens a picker listing this agent's enabled skills by name and `/slug`. Arrow keys browse, Enter or Tab selects and inserts `/slug ` into the composer, and Esc dismisses it. See [Chat Interface](../chat-canvas/chat.md).
30
73
31
74
## How to Use
32
75
33
76
#### Step 1: Open the Skills panel
34
77
Open the **Edit Agent** modal, keep **Configurations** selected, and click **Skills** in the sidebar.
35
78
36
-
#### Step 2: Create a skill (if needed)
37
-
Click **New Skill**, fill in at least the required **Name** and **Slug**, add a description and instruction text describing the capability, and save. The skill becomes available to every agent in the organization.
79
+
#### Step 2: Attach skills from the catalog
80
+
Open the **Available Skills** tab and click **Add to Agent** on each skill this agent should carry. Skills already covered show a green **Added** chip.
81
+
82
+
#### Step 3: Create a skill (if needed)
83
+
Click **New Skill**, fill in at least **Name** and **Slug**, write the **Instruction** playbook, and save. Leave **Only This Agent** off to share the skill across the organization, or turn it on to keep it private to this agent.
84
+
85
+
#### Step 4: Attach files to a skill
86
+
Open the skill's **Edit** dialog, switch to **Resources**, and click **New Resource**. Add references and scripts as text, or upload assets as files.
38
87
39
-
#### Step 3: Assign skills to this agent
40
-
Toggle on each skill this agent should have — for example, Web Research for an agent that should research on the web. The assignment takes effect for this agent's conversations.
88
+
#### Step 5: Enable, disable, and detach
89
+
Use the toggle on the **Agent Skills** tab to turn a skill on or off for this agent, or **Remove from Agent** in the kebab menu to detach it entirely. Remember that **Edit** and **Delete** apply organization-wide.
41
90
42
-
#### Step 4: Maintain skills
43
-
Use the "..." menu to edit a skill's definition or delete it. Remember these actions apply organization-wide; to remove a capability from just this agent, use the toggle instead.
91
+
#### Step 6: Use the skill in chat
92
+
Start a new chat session with the agent, type `/`, and pick the skill from the list. Additions and removals apply to new sessions only; instruction edits take effect immediately.
0 commit comments