From 8673151ebdb1e6a101bc4cb3e2c2beb6e0141b7c Mon Sep 17 00:00:00 2001 From: Dragon <52599892+DragonnZhang@users.noreply.github.com> Date: Sat, 1 Aug 2026 23:23:08 +0800 Subject: [PATCH] docs: document skill learning and live reload (#8298) --- docs/users/features/commands.md | 1 + docs/users/features/skills.md | 33 ++++++++++++++++++++++++++++++++- 2 files changed, 33 insertions(+), 1 deletion(-) diff --git a/docs/users/features/commands.md b/docs/users/features/commands.md index b8429fae64..6ac20b12a1 100644 --- a/docs/users/features/commands.md +++ b/docs/users/features/commands.md @@ -83,6 +83,7 @@ Commands for managing AI tools and models. | `/import-config` | Import MCP servers from Claude configs | `/import-config all`, `/import-config claude-code`, `/import-config claude-desktop --scope user\|project` | | `/tools` | Display currently available tool list | `/tools`, `/tools desc` | | `/skills` | Open the Skills panel to browse, search, toggle, and launch skills | `/skills`, `/` | +| `/learn` | Create a reusable project skill from a file, directory, URL, video, or text | `/learn https://docs.example.com/api`, `/learn ./tutorial.mp4 focus on deployment` | | `/curator` | Inspect, pin, archive, or restore inactive project auto-skills | `/curator`, `/curator run --dry-run`, `/curator pin `, `/curator restore ` | | `/plan` | Switch to plan mode or exit plan mode | `/plan`, `/plan `, `/plan exit` | | `/approval-mode` | Change the tool-approval mode (current session only) | `/approval-mode`, `/approval-mode auto-edit` | diff --git a/docs/users/features/skills.md b/docs/users/features/skills.md index 591196f199..f1243175a4 100644 --- a/docs/users/features/skills.md +++ b/docs/users/features/skills.md @@ -38,6 +38,33 @@ Start typing `/` to autocomplete and browse available Skills alongside their des Skills are stored as directories containing a `SKILL.md` file. +### Generate a project Skill with `/learn` + +Use `/learn` to distill an existing knowledge source into a reusable project +Skill: + +```text +/learn https://docs.example.com/api +/learn ~/projects/acme-sdk +/learn Our deploy process: run migrate, deploy the service, then check health +``` + +The command runs as a normal agent turn and creates the result under +`.qwen/skills/learned-skill-/SKILL.md` with `source: learned` in its +frontmatter. Review the generated instructions before using or sharing them. + +`/learn` also accepts local or direct-link `.mp4`, `.webm`, `.mov`, and `.m4v` +videos. Add text after the path or URL to focus the generated Skill on one part +of the tutorial: + +```text +/learn ./tutorial.mp4 focus on the deployment workflow +``` + +Video learning requires a video-capable model on an OpenAI-compatible provider. +YouTube page URLs are not direct video input; download the video into the +workspace and pass its local path instead. + ### Personal Skills Personal Skills are available across all your projects. Store them in `~/.qwen/skills/`: @@ -197,6 +224,7 @@ Qwen Code discovers Skills from: - Personal Skills: `~/.qwen/skills/` - Project Skills: `.qwen/skills/` - Extension Skills: Skills provided by installed extensions +- Bundled Skills: Skills shipped with Qwen Code ### Extension Skills @@ -324,7 +352,10 @@ code ~/.qwen/skills/my-skill/SKILL.md code .qwen/skills/my-skill/SKILL.md ``` -Changes take effect the next time you start Qwen Code. If Qwen Code is already running, restart it to load the updates. +During a normal session, Qwen Code watches personal and project Skill +directories. Adding, editing, or removing a Skill refreshes the Skill list and +invocation state automatically after a short delay. Bare mode does not start +these watchers, so restart Qwen Code to load Skill changes in that mode. ## Remove a Skill