Skip to content

Commit a4ffc6e

Browse files
tanzhenxinqwencoder
tanzhenxin
and
qwencoder
committed
feat: promote Agent Skills from experimental to stable
Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
1 parent 139e621 commit a4ffc6e

28 files changed

Lines changed: 196 additions & 341 deletions

File tree

‎docs/developers/sdk-java.md‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -245,7 +245,6 @@ The `TransportOptions` class allows configuration of how the SDK communicates wi
245245
- `allowedTools`: List of tools that are pre-approved for use without additional confirmation
246246
- `authType`: Authentication type to use for the session
247247
- `includePartialMessages`: Enables receiving partial messages during streaming responses
248-
- `skillsEnable`: Enables or disables skills functionality for the session
249248
- `turnTimeout`: Timeout for a complete turn of conversation
250249
- `messageTimeout`: Timeout for individual messages within a turn
251250
- `resumeSessionId`: ID of a previous session to resume

‎docs/users/configuration/settings.md‎

Lines changed: 1 addition & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ Qwen Code uses JSON settings files for persistent configuration. There are four
4343
In addition to a project settings file, a project's `.qwen` directory can contain other project-specific files related to Qwen Code's operation, such as:
4444

4545
- [Custom sandbox profiles](../features/sandbox) (e.g. `.qwen/sandbox-macos-custom.sb`, `.qwen/sandbox.Dockerfile`).
46-
- [Agent Skills](../features/skills) (experimental) under `.qwen/skills/` (each Skill is a directory containing a `SKILL.md`).
46+
- [Agent Skills](../features/skills) under `.qwen/skills/` (each Skill is a directory containing a `SKILL.md`).
4747

4848
### Configuration migration
4949

@@ -359,12 +359,6 @@ LSP server configuration is done through `.lsp.json` files in your project root
359359
>
360360
> **Note about advanced.tavilyApiKey:** This is a legacy configuration format. For Qwen OAuth users, DashScope provider is automatically available without any configuration. For other authentication types, configure Tavily or Google providers using the new `webSearch` configuration format.
361361
362-
#### experimental
363-
364-
| Setting | Type | Description | Default |
365-
| --------------------- | ------- | -------------------------------- | ------- |
366-
| `experimental.skills` | boolean | Enable experimental Agent Skills | `false` |
367-
368362
#### mcpServers
369363

370364
Configures connections to one or more Model-Context Protocol (MCP) servers for discovering and using custom tools. Qwen Code attempts to connect to each configured MCP server to discover available tools. If multiple MCP servers expose a tool with the same name, the tool names will be prefixed with the server alias you defined in the configuration (e.g., `serverAlias__actualToolName`) to avoid conflicts. Note that the system might strip certain schema properties from MCP tool definitions for compatibility. At least one of `command`, `url`, or `httpUrl` must be provided. If multiple are specified, the order of precedence is `httpUrl`, then `url`, then `command`.
@@ -534,7 +528,6 @@ Arguments passed directly when running the CLI can override other configurations
534528
| `--telemetry-log-prompts` | | Enables logging of prompts for telemetry. | | See [telemetry](../../developers/development/telemetry) for more information. |
535529
| `--checkpointing` | | Enables [checkpointing](../features/checkpointing). | | |
536530
| `--acp` | | Enables ACP mode (Agent Client Protocol). Useful for IDE/editor integrations like [Zed](../integration-zed). | | Stable. Replaces the deprecated `--experimental-acp` flag. |
537-
| `--experimental-skills` | | Enables experimental [Agent Skills](../features/skills) (registers the `skill` tool and loads Skills from `.qwen/skills/` and `~/.qwen/skills/`). | | Experimental. |
538531
| `--experimental-lsp` | | Enables experimental [LSP (Language Server Protocol)](../features/lsp) feature for code intelligence (go-to-definition, find references, diagnostics, etc.). | | Experimental. Requires language servers to be installed. |
539532
| `--extensions` | `-e` | Specifies a list of extensions to use for the session. | Extension names | If not provided, all available extensions are used. Use the special term `qwen -e none` to disable all extensions. Example: `qwen -e my-extension -e my-other-extension` |
540533
| `--list-extensions` | `-l` | Lists all available extensions and exits. | | |

‎docs/users/features/_meta.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
export default {
22
commands: 'Commands',
33
'sub-agents': 'SubAgents',
4-
skills: 'Skills (Experimental)',
4+
skills: 'Skills',
55
headless: 'Headless Mode',
66
checkpointing: {
77
display: 'hidden',

‎docs/users/features/commands.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ Commands for managing AI tools and models.
5959
| ---------------- | --------------------------------------------- | --------------------------------------------- |
6060
| `/mcp` | List configured MCP servers and tools | `/mcp`, `/mcp desc` |
6161
| `/tools` | Display currently available tool list | `/tools`, `/tools desc` |
62-
| `/skills` | List and run available skills (experimental) | `/skills`, `/skills <name>` |
62+
| `/skills` | List and run available skills | `/skills`, `/skills <name>` |
6363
| `/approval-mode` | Change approval mode for tool usage | `/approval-mode <mode (auto-edit)> --project` |
6464
| →`plan` | Analysis only, no execution | Secure review |
6565
| →`default` | Require approval for edits | Daily use |

‎docs/users/features/headless.md‎

Lines changed: 13 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -189,20 +189,19 @@ qwen -p "Write code" --output-format stream-json --include-partial-messages | jq
189189

190190
Key command-line options for headless usage:
191191

192-
| Option | Description | Example |
193-
| ---------------------------- | ------------------------------------------------------- | ------------------------------------------------------------------------ |
194-
| `--prompt`, `-p` | Run in headless mode | `qwen -p "query"` |
195-
| `--output-format`, `-o` | Specify output format (text, json, stream-json) | `qwen -p "query" --output-format json` |
196-
| `--input-format` | Specify input format (text, stream-json) | `qwen --input-format text --output-format stream-json` |
197-
| `--include-partial-messages` | Include partial messages in stream-json output | `qwen -p "query" --output-format stream-json --include-partial-messages` |
198-
| `--debug`, `-d` | Enable debug mode | `qwen -p "query" --debug` |
199-
| `--all-files`, `-a` | Include all files in context | `qwen -p "query" --all-files` |
200-
| `--include-directories` | Include additional directories | `qwen -p "query" --include-directories src,docs` |
201-
| `--yolo`, `-y` | Auto-approve all actions | `qwen -p "query" --yolo` |
202-
| `--approval-mode` | Set approval mode | `qwen -p "query" --approval-mode auto_edit` |
203-
| `--continue` | Resume the most recent session for this project | `qwen --continue -p "Pick up where we left off"` |
204-
| `--resume [sessionId]` | Resume a specific session (or choose interactively) | `qwen --resume 123e... -p "Finish the refactor"` |
205-
| `--experimental-skills` | Enable experimental Skills (registers the `skill` tool) | `qwen --experimental-skills -p "What Skills are available?"` |
192+
| Option | Description | Example |
193+
| ---------------------------- | --------------------------------------------------- | ------------------------------------------------------------------------ |
194+
| `--prompt`, `-p` | Run in headless mode | `qwen -p "query"` |
195+
| `--output-format`, `-o` | Specify output format (text, json, stream-json) | `qwen -p "query" --output-format json` |
196+
| `--input-format` | Specify input format (text, stream-json) | `qwen --input-format text --output-format stream-json` |
197+
| `--include-partial-messages` | Include partial messages in stream-json output | `qwen -p "query" --output-format stream-json --include-partial-messages` |
198+
| `--debug`, `-d` | Enable debug mode | `qwen -p "query" --debug` |
199+
| `--all-files`, `-a` | Include all files in context | `qwen -p "query" --all-files` |
200+
| `--include-directories` | Include additional directories | `qwen -p "query" --include-directories src,docs` |
201+
| `--yolo`, `-y` | Auto-approve all actions | `qwen -p "query" --yolo` |
202+
| `--approval-mode` | Set approval mode | `qwen -p "query" --approval-mode auto_edit` |
203+
| `--continue` | Resume the most recent session for this project | `qwen --continue -p "Pick up where we left off"` |
204+
| `--resume [sessionId]` | Resume a specific session (or choose interactively) | `qwen --resume 123e... -p "Finish the refactor"` |
206205

207206
For complete details on all available configuration options, settings files, and environment variables, see the [Configuration Guide](../configuration/settings).
208207

‎docs/users/features/skills.md‎

Lines changed: 16 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -1,39 +1,12 @@
1-
# Agent Skills (Experimental)
1+
# Agent Skills
22

3-
> Create, manage, and share Skills to extend Qwen Code’s capabilities.
3+
> Create, manage, and share Skills to extend Qwen Code's capabilities.
44
5-
This guide shows you how to create, use, and manage Agent Skills in **Qwen Code**. Skills are modular capabilities that extend the model’s effectiveness through organized folders containing instructions (and optionally scripts/resources).
6-
7-
> [!note]
8-
>
9-
> Skills are currently **experimental** and must be enabled with `--experimental-skills`.
5+
This guide shows you how to create, use, and manage Agent Skills in **Qwen Code**. Skills are modular capabilities that extend the model's effectiveness through organized folders containing instructions (and optionally scripts/resources).
106

117
## Prerequisites
128

139
- Qwen Code (recent version)
14-
15-
## How to enable
16-
17-
### Via CLI flag
18-
19-
```bash
20-
qwen --experimental-skills
21-
```
22-
23-
### Via settings.json
24-
25-
Add to your `~/.qwen/settings.json` or project's `.qwen/settings.json`:
26-
27-
```json
28-
{
29-
"tools": {
30-
"experimental": {
31-
"skills": true
32-
}
33-
}
34-
}
35-
```
36-
3710
- Basic familiarity with Qwen Code ([Quickstart](../quickstart.md))
3811

3912
## What are Agent Skills?
@@ -42,15 +15,15 @@ Agent Skills package expertise into discoverable capabilities. Each Skill consis
4215

4316
### How Skills are invoked
4417

45-
Skills are **model-invoked** — the model autonomously decides when to use them based on your request and the Skill’s description. This is different from slash commands, which are **user-invoked** (you explicitly type `/command`).
18+
Skills are **model-invoked** — the model autonomously decides when to use them based on your request and the Skill's description. This is different from slash commands, which are **user-invoked** (you explicitly type `/command`).
4619

4720
If you want to invoke a Skill explicitly, use the `/skills` slash command:
4821

4922
```bash
5023
/skills <skill-name>
5124
```
5225

53-
The `/skills` command is only available when you run with `--experimental-skills`. Use autocomplete to browse available Skills and descriptions.
26+
Use autocomplete to browse available Skills and descriptions.
5427

5528
### Benefits
5629

@@ -74,7 +47,7 @@ mkdir -p ~/.qwen/skills/my-skill-name
7447
Use personal Skills for:
7548

7649
- Your individual workflows and preferences
77-
- Experimental Skills you’re developing
50+
- Skills you're developing
7851
- Personal productivity helpers
7952

8053
### Project Skills
@@ -153,7 +126,7 @@ python scripts/helper.py input.txt
153126

154127
## View available Skills
155128

156-
When `--experimental-skills` is enabled, Qwen Code discovers Skills from:
129+
Qwen Code discovers Skills from:
157130

158131
- Personal Skills: `~/.qwen/skills/`
159132
- Project Skills: `.qwen/skills/`
@@ -163,10 +136,7 @@ When `--experimental-skills` is enabled, Qwen Code discovers Skills from:
163136

164137
Extensions can provide custom skills that become available when the extension is enabled. These skills are stored in the extension's `skills/` directory and follow the same format as personal and project skills.
165138

166-
Extension skills are automatically discovered and loaded when:
167-
168-
- The extension is installed and enabled
169-
- The `--experimental-skills` flag is enabled
139+
Extension skills are automatically discovered and loaded when the extension is installed and enabled.
170140

171141
To see which extensions provide skills, check the extension's `qwen-extension.json` file for a `skills` field.
172142

@@ -185,25 +155,25 @@ ls ~/.qwen/skills/
185155
# List project Skills (if in a project directory)
186156
ls .qwen/skills/
187157

188-
# View a specific Skill’s content
158+
# View a specific Skill's content
189159
cat ~/.qwen/skills/my-skill/SKILL.md
190160
```
191161

192162
## Test a Skill
193163

194164
After creating a Skill, test it by asking questions that match your description.
195165

196-
Example: if your description mentions “PDF files”:
166+
Example: if your description mentions "PDF files":
197167

198168
```text
199169
Can you help me extract text from this PDF?
200170
```
201171

202-
The model autonomously decides to use your Skill if it matches the request — you don’t need to explicitly invoke it.
172+
The model autonomously decides to use your Skill if it matches the request — you don't need to explicitly invoke it.
203173

204174
## Debug a Skill
205175

206-
If Qwen Code doesn’t use your Skill, check these common issues:
176+
If Qwen Code doesn't use your Skill, check these common issues:
207177

208178
### Make the description specific
209179

@@ -251,7 +221,7 @@ Ensure:
251221
Run Qwen Code with debug mode to see Skill loading errors:
252222

253223
```bash
254-
qwen --experimental-skills --debug
224+
qwen --debug
255225
```
256226

257227
## Share Skills with your team
@@ -260,7 +230,7 @@ You can share Skills through project repositories:
260230

261231
1. Add the Skill under `.qwen/skills/`
262232
2. Commit and push
263-
3. Teammates pull the changes and run with `--experimental-skills`
233+
3. Teammates pull the changes
264234

265235
```bash
266236
git add .qwen/skills/
@@ -301,8 +271,8 @@ git commit -m "Remove unused Skill"
301271

302272
One Skill should address one capability:
303273

304-
- Focused: “PDF form filling”, “Excel analysis”, “Git commit messages”
305-
- Too broad: “Document processing” (split into smaller Skills)
274+
- Focused: "PDF form filling", "Excel analysis", "Git commit messages"
275+
- Too broad: "Document processing" (split into smaller Skills)
306276

307277
### Write clear descriptions
308278

0 commit comments

Comments
 (0)