Guide · Agent skill
How to use the Weibo Video Uploader agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The weibo-upload skill lets an AI agent publish videos to Weibo by calling the existing social-auto-upload command-line tool (the sau CLI), instead of driving a browser upload itself. This guide explains what the skill does, how to install it, how to phrase requests so the agent triggers it, and what to check before anything goes live. It is written for readers who have never installed an agent skill before.
Weibo Video Uploaderdreammis/social-auto-upload · MIT Download the skill Quick start
- 1Install social-auto-upload. Make sure the sau command is installed and available on your command line before using the skill.
- 2Download and unzip the skill. Download the weibo-upload ZIP from this page and unzip it so the folder contains SKILL.md.
- 3Place the skill folder. Put it in ~/.claude/skills/ for personal use, in a project's .claude/skills/ folder, or upload it under Settings → Capabilities → Skills in the Claude apps.
- 4Log in to Weibo. Run sau weibo login with an account alias, then scan the QR code shown on your phone if one appears.
- 5Check the account. Run sau weibo check with the same alias to confirm the login is still valid.
- 6Upload a video. Ask the agent to publish your video, or run sau weibo upload-video with the file, title, description, tags and optional cover.
- 7Confirm the result. Check the platform's response, and if the status is unclear, look at the original post in the Weibo backend instead of re-uploading.
What the weibo-upload skill makes the agent do
A skill is a folder of instructions that an AI agent loads when a task matches its description. This one covers publishing videos to Weibo, a Chinese social media platform. Its description says it is used when a user wants to publish a video to Weibo or check a Weibo account's status.
The skill relies on the social-auto-upload tool rather than writing its own upload flow. Once it is set up, the agent can log in to a Weibo account, check whether that login is still valid, and upload a video with a title, description, tags and an optional cover image.
- Log in to a Weibo account through the sau tool
- Check whether the stored login is still valid
- Upload a video with title, description, tags and an optional cover
Install the weibo-upload skill
Download the skill ZIP from this page and unzip it. For a personal setup, place the unzipped weibo-upload folder in ~/.claude/skills/. For a single project, place it in that project's .claude/skills/ folder.
If you use the Claude apps, you can instead upload the skill under Settings → Capabilities → Skills.
The skill package contains a single file, SKILL.md, which holds the instructions the agent follows. Before using the skill, install social-auto-upload so that the sau command is available on your command line.
- Personal: ~/.claude/skills/
- Project: .claude/skills/ inside the project folder
- Claude apps: Settings → Capabilities → Skills
Log in and check your Weibo account
The account name you pass to the tool is a local session alias, so choose a short name you will recognise. Run the login command first. If a QR code appears, the tool shows the QR image and you scan it with your phone to finish logging in.
Use the check command to confirm the login is still valid before you upload. The skill's source does not describe what the check output looks like, so read the tool's own output and use sau weibo --help or the command's help for details.
- Login is kept as a local session tied to the alias
- Scan the displayed QR code with your phone when prompted
sau weibo login --account creator
sau weibo check --account creatorUpload a video with a title, tags and cover
The upload command takes the account alias, the video file path, a title, a description, comma-separated tags and an optional cover image. The example below uploads videos/demo.mp4 with a cover from covers/demo.png.
Titles are limited to 30 characters, and covers are recommended to be under 5 MB. The full set of options is listed in the tool's help, so run sau weibo upload-video --help when you need a flag not shown here.
- --file: path to the video
- --title: up to 30 characters
- --desc: description text
- --tags: comma-separated tags
- --thumbnail: optional cover image, ideally under 5 MB
sau weibo upload-video --account creator --file videos/demo.mp4 --title "标题" --desc "简介" --tags 微博,测试 --thumbnail covers/demo.pngAsk the agent in natural language
You do not need to type the commands yourself. Describe the task in plain words and mention Weibo and the video. The agent should match the request to this skill and run the sau commands.
Give the agent the details it needs: which account alias to use, which file to post, the title, the description, the tags and any cover image. Asking it to check the account first is a sensible habit.
- "Check whether my Weibo account creator is still logged in."
- "Post videos/demo.mp4 to Weibo under account creator with the title I give you and tags weibo and test."
- "Upload this video to Weibo with covers/demo.png as the cover."
Safety, limits and what to check before publishing
The skill runs scripts and uses the network, because it calls the sau command-line tool and talks to Weibo. Only install skills you trust, and review what the tool will run.
The skill supports video only. Image posts, text-only posts and scheduled publishing are not supported. Before submitting, the agent should verify the account, video, title length, description, tags and cover. After submitting, it reports only the platform's actual response. If a result times out or the status is unclear, check the original post in the Weibo backend rather than uploading again, to avoid duplicates.
- Verify account, video, title, description, tags and cover before submitting
- Do not re-upload when the status is unclear; check the Weibo backend first
- Login sessions are stored locally, so use this only on a machine where that is acceptable
What people use it for
- Publishing a finished video from a local folder to a Weibo account with a set title and tags
- Checking whether a creator's saved Weibo login is still valid before a scheduled posting session
- Adding a custom cover image to a video upload
- Letting a developer's agent run existing sau Weibo commands without writing new upload code
Frequently asked questions
What is the weibo-upload agent skill?
It is a skill, a folder with instructions for an AI agent, that teaches the agent to publish videos to Weibo and check account status. It does this by calling the social-auto-upload sau command-line tool rather than uploading through a browser itself.
What do I need to use it?
You need social-auto-upload installed with the sau command available on your command line, and a Weibo account that you log into through the tool. When prompted, you scan a QR code with your phone.
Is the weibo-upload skill free and what is its licence?
The skill is listed under the MIT licence in the source repository. The source does not mention pricing, so check the repository for any terms that apply to the tool itself.
Can it post images or schedule posts?
No. The skill supports video only. The source states that image posts and scheduled publishing are not supported.
Why does the agent say not to re-upload after a timeout?
If the result is unclear, a second upload could create a duplicate post. The skill tells the agent to check the original work in the Weibo backend first.
How is this different from uploading by hand or using another tool?
Instead of driving a browser upload, this skill calls the existing sau CLI, so the agent runs the same commands you could type yourself. For other automation options, compare the tools against your own needs; the source does not compare them.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
This skill suits creators, marketers and developers who already want to automate video posting to Weibo through the sau tool and will review each upload. It is a poor fit for image or text posts, scheduled publishing, unattended bulk posting, or accounts whose login session you cannot safely store on a local machine.
Download the skill