diff --git a/docs/users/configuration/settings.md b/docs/users/configuration/settings.md
index 58f0543ef..90d71040a 100644
--- a/docs/users/configuration/settings.md
+++ b/docs/users/configuration/settings.md
@@ -275,6 +275,7 @@ If you are experiencing performance issues with file searching (e.g., with `@` c
 | `tools.truncateToolOutputThreshold`  | number            | Truncate tool output if it is larger than this many characters. Applies to Shell, Grep, Glob, ReadFile and ReadManyFiles tools.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | `25000`     | Requires restart: Yes                                                                                                                                                                                                                                |
 | `tools.truncateToolOutputLines`      | number            | Maximum lines or entries kept when truncating tool output. Applies to Shell, Grep, Glob, ReadFile and ReadManyFiles tools.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | `1000`      | Requires restart: Yes                                                                                                                                                                                                                                |
 | `tools.autoAccept`                   | boolean           | Controls whether the CLI automatically accepts and executes tool calls that are considered safe (e.g., read-only operations) without explicit user confirmation. If set to `true`, the CLI will bypass the confirmation prompt for tools deemed safe.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | `false`     |                                                                                                                                                                                                                                                      |
+| `tools.experimentalSkills`           | boolean           | Enable experimental Agent Skills feature                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | `false`     |                                                                                                                                                                                                                                                      |
 
 #### mcp
 
diff --git a/docs/users/features/skills.md b/docs/users/features/skills.md
index 0387ff389..9ae65f715 100644
--- a/docs/users/features/skills.md
+++ b/docs/users/features/skills.md
@@ -11,10 +11,29 @@ This guide shows you how to create, use, and manage Agent Skills in **Qwen Code*
 ## Prerequisites
 
 - Qwen Code (recent version)
-- Run with the experimental flag enabled:
+
+## How to enable
+
+### Via CLI flag
 
 ```bash
+# Long form
 qwen --experimental-skills
+
+# Short form
+qwen --skills
+```
+
+### Via settings.json
+
+Add to your `~/.qwen/settings.json` or project's `.qwen/settings.json`:
+
+```json
+{
+  "tools": {
+    "experimentalSkills": true
+  }
+}
 ```
 
 - Basic familiarity with Qwen Code ([Quickstart](../quickstart.md))
diff --git a/packages/cli/src/config/config.ts b/packages/cli/src/config/config.ts
index 8dd09a238..66baf2ab6 100755
--- a/packages/cli/src/config/config.ts
+++ b/packages/cli/src/config/config.ts
@@ -332,9 +332,10 @@ export async function parseArguments(settings: Settings): Promise<CliArgs> {
           hidden: true,
         })
         .option('experimental-skills', {
+          alias: ['x'],
           type: 'boolean',
-          description: 'Enable experimental Skills feature',
-          default: false,
+          description: 'Enable experimental Skills feature (short:  -x)',
+          default: settings.tools?.experimentalSkills ?? false,
         })
         .option('channel', {
           type: 'string',
diff --git a/packages/cli/src/config/settingsSchema.ts b/packages/cli/src/config/settingsSchema.ts
index 74b63a7b9..4366563af 100644
--- a/packages/cli/src/config/settingsSchema.ts
+++ b/packages/cli/src/config/settingsSchema.ts
@@ -981,6 +981,16 @@ const SETTINGS_SCHEMA = {
         description: 'The number of lines to keep when truncating tool output.',
         showInDialog: true,
       },
+      experimentalSkills: {
+        type: 'boolean',
+        label: 'Experimental Skills',
+        category: 'Tools',
+        requiresRestart: true,
+        default: false,
+        description:
+          'Enable experimental Agent Skills feature.  When enabled, Qwen Code can use Skills from . qwen/skills/ and ~/. qwen/skills/.',
+        showInDialog: true,
+      },
     },
   },