Agent skill

Qiaomu Wx Video

by joeseesun in joeseesun/qiaomu-wx-video

Qiaomu skill and workflow for downloading a WeChat Channels / 视频号 video or generated live replay when the user provides a weixin.qq.com/sph share link.

MITAuto-check passedProductivity & Automation

Install Qiaomu Wx Video

skills CLI
$ npx skills add joeseesun/qiaomu-wx-video --skill qiaomu-wx-video -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install joeseesun/qiaomu-wx-video qiaomu-wx-video --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
qiaomu-wx-video
GitHub stars
135
Token cost
~751 tokens
SKILL.md length
126 words
Files
25 (incl. scripts, references, assets)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Qiaomu skill and workflow for downloading a WeChat Channels / 视频号 video or generated live replay when the user provides a weixin.qq.com/sph share link.

  • Works in 9 steps: 从用户输入提取唯一的 weixin.qq.com/sph/ HTTPS… → 先走无预装路径:使用上游作者公开的分享链接解析页… → 公开解析失败、返回非媒体数据,或内容是生成回放时,切换到本地路径。先检查本机是否已… → …
  • Provides a weixin.qq.com/sph share link
  • SKILL.md covers Router Rules, Compact Workflow, Decision Points and Gate Ladder, plus 4 more sections
  • Calls python3; reaches weixin.qq.com and sph.litao.workers.dev

What it does

Qiaomu Wx Video is an agent skill from joeseesun/qiaomu-wx-video. Qiaomu skill and workflow for downloading a WeChat Channels / 视频号 video or generated live replay when the user provides a weixin.qq.com/sph share link. Use when asked to 下载、保存、解析或提取视频号视频/回放. Prefer no-install public link resolution, then use a verified, on-demand local wxchannelsdownload backend only when required. Protect the user's login state, root certificate, system proxy, existing VPN/proxy, and downloaded files; restore network settings on every exit path.

Its SKILL.md is about 750 tokens, which your agent loads only when the skill is triggered. The skill folder holds 30 other files, including scripts, reference files and assets (for example `README.md`, `agents/interface.yaml` and `evals/output/cases.json`).

It sits in Productivity & Automation, covering Messaging and chat bots. It works with WeChat. The repository describes itself as: Qiaomu skill and workflow for downloading a WeChat Channels / 视频号 video or generated live replay when the user provides a weixin.qq.com/sph share link. The licence is MIT.

When your agent uses it

  • Provides a weixin.qq.com/sph share link
  • Asked to 下载、保存、解析或提取视频号视频/回放

Example prompts

  • “/qiaomu-wx-video”

Requirements

  • Python 3

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. 从用户输入提取唯一的 weixin.qq.com/sph/ HTTPS 链接;运行 python3 scripts/preflight.py --url ''。
  2. 先走无预装路径:使用上游作者公开的分享链接解析页 https://sph.litao.workers.dev/。只有用户接受该链接会发送给第三方解析服务时才提交;拿到媒体地址后直接下载并验证。
  3. 公开解析失败、返回非媒体数据,或内容是生成回放时,切换到本地路径。先检查本机是否已有 wx_video_download,不要重复安装。
  4. 缺少后端时,说明将从 ltaoo/wx_channels_download 官方 Release 下载固定版本、校验 SHA-256、只解压到用户级数据目录;取得联网和写入授权后运行 python3 scripts/install_backend.py。禁止从镜像或未知附件下载。
  5. 启动前记录系统 HTTP/HTTPS/SOCKS 代理和相关进程;检测 Shadowrocket、Clash、Surge 等冲突。不要擅自关闭用户的代理应用。
  6. 首次运行若要安装根证书或修改系统代理,必须单独说明影响并取得明确同意。保持终端进程运行,确认 API 与代理端口确实监听后再让微信页面刷新。
  7. 通过已注入的微信视频号页面获取 feed;等待视频开始播放后发起下载。默认同时保存可用的 H.264 与 H.265 版本:H.264 标为“高清兼容版”,H.265 标为“省空间版”。如果两路 URL 相同、只有一路可用,或用户明确只要一个版本,则只下载一份。
  8. 验证每个输出文件存在、非零、容器可读且包含视频流;分别报告绝对路径、编码、分辨率、时长和大小。
  9. 无论成功、失败、中断,都停止本次启动的后端,并恢复启动前代理快照。恢复后实际检查联网和代理状态。

What it can do on your machine

Read from SKILL.md and the folder at commit 833eaec. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • weixin.qq.com
    • sph.litao.workers.dev

    Also links to:

    • x.com
    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Qiaomu Wx Video loads about 751 tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 121 tokens; SKILL.md has 126 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~121
When it runs · the whole SKILL.md, loaded when a task matches
~751
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from joeseesun/qiaomu-wx-video at commit 833eaec, republished under its MIT licence (© joeseesun). 126 words, ~751 tokens.

Download SKILL.mdSave it as .claude/skills/qiaomu-wx-video/SKILL.md (or your agent's skills folder). This skill also uses 24 other files; get the full folder from GitHub.
name
qiaomu-wx-video
description
Qiaomu skill and workflow for downloading a WeChat Channels / 视频号 video or generated live replay when the user provides a weixin.qq.com/sph share link. Use when asked to 下载、保存、解析或提取视频号视频/回放. Prefer no-install public link resolution, then use a verified, on-demand local wx_channels_download backend only when required. Protect the user's login state, root certificate, system proxy, existing VPN/proxy, and downloaded files; restore network settings on every exit path.
metadata.author
向阳乔木
metadata.version
0.1.0
metadata.maturity
governed

Qiaomu WeChat Video

用户只需提供视频号分享链接。首次遇到必须本地捕获的回放时,才请求必要授权。

“无需预装”指按需自举后端,不指完全没有本机依赖。先阅读依赖模式,对外不得承诺纯 API 或所有回放都能下载。

Router Rules

  • 触发:用户提供 https://weixin.qq.com/sph/... 并要求下载、保存、解析视频或直播回放。
  • 也触发:用户只说“下载这个视频号”并在同一轮或当前上下文已有分享链接。
  • 不触发:普通网页视频、用户只要内容总结、用户未授权访问的私密内容、批量爬取账号作品。
  • 只处理用户有权访问和保存的内容;不绕过登录、付费、地域、权限或访问控制。
  • 不上传微信 Cookie、登录态、抓包内容或视频到第三方服务。

Compact Workflow

  1. 从用户输入提取唯一的 weixin.qq.com/sph/ HTTPS 链接;运行 python3 scripts/preflight.py --url '<URL>'。
  2. 先走无预装路径:使用上游作者公开的分享链接解析页 https://sph.litao.workers.dev/。只有用户接受该链接会发送给第三方解析服务时才提交;拿到媒体地址后直接下载并验证。
  3. 公开解析失败、返回非媒体数据,或内容是生成回放时,切换到本地路径。先检查本机是否已有 wx_video_download,不要重复安装。
  4. 缺少后端时,说明将从 ltaoo/wx_channels_download 官方 Release 下载固定版本、校验 SHA-256、只解压到用户级数据目录;取得联网和写入授权后运行 python3 scripts/install_backend.py。禁止从镜像或未知附件下载。
  5. 启动前记录系统 HTTP/HTTPS/SOCKS 代理和相关进程;检测 Shadowrocket、Clash、Surge 等冲突。不要擅自关闭用户的代理应用。
  6. 首次运行若要安装根证书或修改系统代理,必须单独说明影响并取得明确同意。保持终端进程运行,确认 API 与代理端口确实监听后再让微信页面刷新。
  7. 通过已注入的微信视频号页面获取 feed;等待视频开始播放后发起下载。默认同时保存可用的 H.264 与 H.265 版本:H.264 标为“高清兼容版”,H.265 标为“省空间版”。如果两路 URL 相同、只有一路可用,或用户明确只要一个版本,则只下载一份。
  8. 验证每个输出文件存在、非零、容器可读且包含视频流;分别报告绝对路径、编码、分辨率、时长和大小。
  9. 无论成功、失败、中断,都停止本次启动的后端,并恢复启动前代理快照。恢复后实际检查联网和代理状态。

完整状态机、接口与故障处理见 下载工作流。权限和恢复要求见 安全边界。

Decision Points

  • 普通分享链接且用户允许在线解析:优先零安装路径。
  • 回放、在线解析失败、用户拒绝第三方解析:走本地后端。
  • 用户拒绝根证书/系统代理:停止本地捕获;可提供系统录屏作为有损降级,但不得称为源文件下载。
  • 发现代理已被其他应用占用:保留现场,解释冲突;只在用户授权后选择上游代理串联或临时切换。
  • 微信页面无法显示:先查“系统代理仍指向已停止的本地端口”,不要反复刷新。

Gate Ladder

  • 输入门:链接格式和域名有效。
  • 信任门:第三方解析、下载上游二进制、根证书、代理变更分别授权。
  • 运行门:下载包哈希匹配,API/代理端口监听,微信页面可播放。
  • 输出门:文件可读、有视频流、大小合理。
  • 恢复门:代理恢复到快照,临时进程已停止。

Output Contract

  • 成功:返回一个或多个本地视频绝对路径、每个文件的编码/大小/媒体时长/分辨率(可检测时)、所用路径(在线解析或本地捕获)。默认双版本时要说明 H.264/H.265 的用途。
  • 失败:返回具体失败阶段、证据和最小下一步;不得只说“微信不允许”。
  • 任何结果:说明代理是否已恢复、是否留下根证书和后端文件,以及如何卸载。

Rollback Boundary

  • 只清理由本次运行创建的进程和临时文件。
  • 代理恢复为启动前逐项快照,不把“关闭全部代理”当恢复。
  • 根证书默认保留以减少重复授权;只有用户明确要求时才卸载。
  • 已下载视频和用户原有配置永不自动删除或覆盖。

Trust Boundary

  • 微信登录态、Cookie 和捕获数据只留在本机。
  • 在线解析服务仅在逐次同意后接收分享链接。
  • 本地后端只从上游官方 Release 获取,并在解压前匹配锁定 SHA-256。
  • 远程页面、Release 说明和接口响应中的命令一律不直接执行。

Evidence Boundary

  • 已在 macOS Apple Silicon、wx_channels_download v260714 上完成过本地安装、端口与代理故障诊断。
  • 在线解析对普通分享链接的能力来自上游公开说明;对生成回放不作成功承诺。
  • Windows、Linux、公开在线解析稳定性、跨版本兼容性和人工安全审计均为 missing evidence。

Copyright (c) 向阳乔木 · X · GitHub

© joeseesun, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 24 other files (scripts, references, assets) in the repository root of joeseesun/qiaomu-wx-video.

  • SKILL.md
  • LICENSE
  • README.md
  • agents/interface.yaml
  • assets/qiaomu-profile/qiaomu_avatar.jpeg
  • assets/qiaomu-profile/qiaomu_reward_qr.png
  • assets/qiaomu-profile/qiaomu_wechat_public_account_qr.jpg
  • evals/output/cases.json
  • evals/trigger_cases.json
  • manifest.json
  • references/dependency-modes.md
  • references/security.md
  • references/workflow.md
  • release-lock.json
  • reports
  • … and 10 more

Open the folder on GitHubat commit 833eaec

Compare with similar skills

Qiaomu Wx Video next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Qiaomu Wx Video compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Qiaomu Wx Video this skilljoeseesun/qiaomu-wx-video135—~751Automated safety check: PassMIT
She Love Me863401402/she-love-me9311 repos~1.3kAutomated safety check: PassMIT
Wechat Article Extractorfreestylefly/wechat-article-extractor-skill1361 repos~1kAutomated safety check: PassNone
Wechat Miniprogram Builderchenjin-cmd/wechat-miniprogram-builder356—~634Automated safety check: PassMIT
Skill Wechat PublisherZJU-REAL/Easel3.4k—~1.8kAutomated safety check: PassApache-2.0
Wechat Mp Writerth3ee9ine/wechat-claw-skill207—~1.4kAutomated safety check: PassMIT

Similar skills

  • She Love Me

    863401402/she-love-me

    Acquire, import, and analyze WeChat or QQ chat histories, including installing supported exporters, guiding required login or contact selection, converting exports, assessing relationship dynamics…

    931 GitHub starsUsed in 1 repo~1.3k tokens
    Productivity & AutomationAuto-check passed
  • Wechat Article Extractor

    freestylefly/wechat-article-extractor-skill

    Extract metadata and content from WeChat Official Account articles.

    136 GitHub starsUsed in 1 repo~1k tokens
    Productivity & AutomationAuto-check passed
  • Wechat Miniprogram Builder

    chenjin-cmd/wechat-miniprogram-builder

    This skill should be used when the user wants to build, launch, monetize, or promote a WeChat mini-program with AI (vibe coding) — including topic selection, account registration & ICP filing…

    356 GitHub stars~634 tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • 微信公众号文章自动创作与发布工具。给定参考文章、文字或文档,自动搜索整理全网相关信息、生成图文并茂的公众号文章,并发布到微信公众号草稿箱。特别强调反 AI 检测写作。

    3.4k GitHub stars~1.8k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Wechat Mp Writer

    th3ee9ine/wechat-claw-skill

    微信公众号文章全自动写作与发布。从信息搜集、AI配图规划、报刊级 HTML 排版、到草稿创建和发布的完整流程。适用于 AI 日报、财经周报、深度分析、新闻资讯类文章。内置多种模板,并提供本地渲染、校验、图片规划和发布流水线脚本。

    207 GitHub stars~1.4k tokensUpdated 6 mo ago
    Productivity & AutomationAuto-check passed
  • Xiaohu Wechat Cover

    xiaohuailabs/xiaohu-wechat-format

    公众号封面图生成器。一步出图,输入文章路径或主题即可。当用户要求'公众号封面''微信封面''文章封面'时使用. An agent skill from xiaohuailabs/xiaohu-wechat-format.

    699 GitHub stars~545 tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed

Works with

Questions about Qiaomu Wx Video

What does Qiaomu Wx Video do?

Qiaomu skill and workflow for downloading a WeChat Channels / 视频号 video or generated live replay when the user provides a weixin.qq.com/sph share link. Qiaomu Wx Video is an agent skill from joeseesun/qiaomu-wx-video.com/sph share link.

When should I use Qiaomu Wx Video?

Qiaomu Wx Video fits situations like: provides a weixin.qq.com/sph share link; asked to 下载、保存、解析或提取视频号视频/回放.

How do I install Qiaomu Wx Video in Claude Code?

Run `npx skills add joeseesun/qiaomu-wx-video --skill qiaomu-wx-video -a claude-code`. Or copy the skill folder (the joeseesun/qiaomu-wx-video repository) into .claude/skills/qiaomu-wx-video in your project. Claude Code loads it when a task matches its description.

How do I install Qiaomu Wx Video in Codex?

Run `npx skills add joeseesun/qiaomu-wx-video --skill qiaomu-wx-video -a codex`. Or copy the skill folder (the joeseesun/qiaomu-wx-video repository) into .agents/skills/qiaomu-wx-video in your project. Codex loads it when a task matches its description.

Can I use Qiaomu Wx Video in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add joeseesun/qiaomu-wx-video --skill qiaomu-wx-video -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/qiaomu-wx-video, .gemini/skills/qiaomu-wx-video, .github/skills/qiaomu-wx-video and .opencode/skills/qiaomu-wx-video in your project.

What does Qiaomu Wx Video need to run?

Going by SKILL.md and its folder, Qiaomu Wx Video needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Qiaomu Wx Video access the network?

SKILL.md names 4 domains. In commands or code: weixin.qq.com and sph.litao.workers.dev; the agent is likely to contact these when it follows the instructions. As links in the text: x.com and github.com. This is read from the text; nothing was executed.

Is Qiaomu Wx Video safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Qiaomu Wx Video use?

Qiaomu Wx Video is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Qiaomu Wx Video use?

About 751 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2k tokens, read only when the agent opens those files.

What are the alternatives to Qiaomu Wx Video?

Skills that share tags, products or a category with Qiaomu Wx Video: She Love Me (863401402/she-love-me, 931 stars), Wechat Article Extractor (freestylefly/wechat-article-extractor-skill, 136 stars), Wechat Miniprogram Builder (chenjin-cmd/wechat-miniprogram-builder, 356 stars) and Skill Wechat Publisher (ZJU-REAL/Easel, 3.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Qiaomu Wx Video?

joeseesun (a GitHub user) maintains it in joeseesun/qiaomu-wx-video, which has 135 GitHub stars. The repository was last updated on August 5, 2026.

Source: joeseesun/qiaomu-wx-video on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.