feat: promote Agent Skills from experimental to stable

Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>

docs/users/features/skills.md

@@ -1,39 +1,12 @@
-# Agent Skills (Experimental)
+# Agent Skills
 
-> Create, manage, and share Skills to extend Qwen Code’s capabilities.
+> Create, manage, and share Skills to extend Qwen Code's capabilities.
 
-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).
-
-> [!note]
->
-> Skills are currently **experimental** and must be enabled with `--experimental-skills`.
+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).
 
 ## Prerequisites
 
 - Qwen Code (recent version)
-
-## How to enable
-
-### Via CLI flag
-
-```bash
-qwen --experimental-skills
-```
-
-### Via settings.json
-
-Add to your `~/.qwen/settings.json` or project's `.qwen/settings.json`:
-
-```json
-{
-  "tools": {
-    "experimental": {
-      "skills": true
-    }
-  }
-}
-```
-
 - Basic familiarity with Qwen Code ([Quickstart](../quickstart.md))
 
 ## What are Agent Skills?
@@ -42,7 +15,7 @@ Agent Skills package expertise into discoverable capabilities. Each Skill consis
 
 ### How Skills are invoked
 
-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`).
+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`).
 
 If you want to invoke a Skill explicitly, use the `/skills` slash command:
 
@@ -50,7 +23,7 @@ If you want to invoke a Skill explicitly, use the `/skills` slash command:
 /skills <skill-name>
 ```
 
-The `/skills` command is only available when you run with `--experimental-skills`. Use autocomplete to browse available Skills and descriptions.
+Use autocomplete to browse available Skills and descriptions.
 
 ### Benefits
 
@@ -74,7 +47,7 @@ mkdir -p ~/.qwen/skills/my-skill-name
 Use personal Skills for:
 
 - Your individual workflows and preferences
-- Experimental Skills you’re developing
+- Skills you're developing
 - Personal productivity helpers
 
 ### Project Skills
@@ -153,7 +126,7 @@ python scripts/helper.py input.txt
 
 ## View available Skills
 
-When `--experimental-skills` is enabled, Qwen Code discovers Skills from:
+Qwen Code discovers Skills from:
 
 - Personal Skills: `~/.qwen/skills/`
 - Project Skills: `.qwen/skills/`
@@ -163,10 +136,7 @@ When `--experimental-skills` is enabled, Qwen Code discovers Skills from:
 
 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.
 
-Extension skills are automatically discovered and loaded when:
-
-- The extension is installed and enabled
-- The `--experimental-skills` flag is enabled
+Extension skills are automatically discovered and loaded when the extension is installed and enabled.
 
 To see which extensions provide skills, check the extension's `qwen-extension.json` file for a `skills` field.
 
@@ -185,7 +155,7 @@ ls ~/.qwen/skills/
 # List project Skills (if in a project directory)
 ls .qwen/skills/
 
-# View a specific Skill’s content
+# View a specific Skill's content
 cat ~/.qwen/skills/my-skill/SKILL.md
 ```
 
@@ -193,17 +163,17 @@ cat ~/.qwen/skills/my-skill/SKILL.md
 
 After creating a Skill, test it by asking questions that match your description.
 
-Example: if your description mentions “PDF files”:
+Example: if your description mentions "PDF files":
 
 ```text
 Can you help me extract text from this PDF?
 ```
 
-The model autonomously decides to use your Skill if it matches the request — you don’t need to explicitly invoke it.
+The model autonomously decides to use your Skill if it matches the request — you don't need to explicitly invoke it.
 
 ## Debug a Skill
 
-If Qwen Code doesn’t use your Skill, check these common issues:
+If Qwen Code doesn't use your Skill, check these common issues:
 
 ### Make the description specific
 
@@ -251,7 +221,7 @@ Ensure:
 Run Qwen Code with debug mode to see Skill loading errors:
 
 ```bash
-qwen --experimental-skills --debug
+qwen --debug
 ```
 
 ## Share Skills with your team
@@ -260,7 +230,7 @@ You can share Skills through project repositories:
 
 1. Add the Skill under `.qwen/skills/`
 2. Commit and push
-3. Teammates pull the changes and run with `--experimental-skills`
+3. Teammates pull the changes
 
 ```bash
 git add .qwen/skills/
@@ -301,8 +271,8 @@ git commit -m "Remove unused Skill"
 
 One Skill should address one capability:
 
-- Focused: “PDF form filling”, “Excel analysis”, “Git commit messages”
-- Too broad: “Document processing” (split into smaller Skills)
+- Focused: "PDF form filling", "Excel analysis", "Git commit messages"
+- Too broad: "Document processing" (split into smaller Skills)
 
 ### Write clear descriptions