How to use the 百家号视频发布 agent skill (baijiahao-upload)

What is an agent skill and what does this one do?

An agent skill is a folder containing a SKILL.md file that tells an AI agent how to handle a specific task. This skill, baijiahao-upload, covers publishing videos to Baijiahao. It does not write its own upload code. Instead it tells the agent to run the existing sau baijiahao commands from the social-auto-upload project.

The agent can log in to a Baijiahao account (showing you any QR code the login page displays), check that the saved login session is still valid, and upload a video with a title, description, tags, an optional cover image and an optional collection.

• Supported: video posts with title, description and tags
• Optional: a cover image (--thumbnail) and an existing collection (--collection)
• Not supported: image-text posts and scheduled publishing

What you need before installing

The skill depends on other software. Make sure these are in place first:

• A social-auto-upload project with the sau command-line tool installed
• A Baidu (百度) account with Baijiahao creator access
• A local login session saved with sau baijiahao login

How to install the baijiahao-upload skill

Download the ZIP for this skill from our page and unzip it. You have two options depending on how you use your agent.

For Claude Code, unzip the skill folder into ~/.claude/skills/ for your user account, or into .claude/skills/ inside a specific project. For the Claude apps, open Settings, go to Capabilities, then Skills, and upload the ZIP there.

• Personal install: ~/.claude/skills/
• Project install: .claude/skills/ inside your project folder
• Claude apps: Settings → Capabilities → Skills, then upload the ZIP

Log in and check your account

Account names are local session aliases, not your Baidu username. Pick a name such as creator and use it consistently. Run the login command first; if the login page shows a QR code, the agent will show you the image so you can scan it. Then run the check command to confirm the session still works.

Before you publish anything, look at the upload command's options by running sau baijiahao upload-video --help, as the skill instructs.

Publish a video with the upload command

The upload command takes the account alias, the video file, a title, a description and tags. Tags are passed as a comma-separated list. Add --thumbnail for a cover image or --collection for an existing collection.

The agent checks the account, media file, title, copy and tags before it publishes. Review these yourself as well, since the publish step goes to a live platform.

• --account: the local session alias from login
• --file: path to the video, for example videos/demo.mp4
• --title, --desc, --tags: your post text and comma-separated tags
• --thumbnail: optional cover image path
• --collection: optional name of an existing collection

How to ask the agent in natural language

You do not need to type commands yourself. The skill is triggered when you ask for a Baijiahao video upload or ask to verify your Baijiahao login. Be specific about the account, the file and the copy so the agent can confirm them with you before running anything.

• "Check whether my creator Baijiahao account is still logged in."
• "Publish videos/demo.mp4 to Baijiahao under the creator account with the title and tags I give you."
• "Log in to Baijiahao as creator and show me the QR code if one appears."
• "Upload this video to my Baijiahao collection called [your collection name]."

Safety notes: scripts, network and saved sessions

This skill runs scripts and uses the network. It works by storing a Baidu login session on your machine so later commands do not need you to log in again. Only install it if you are comfortable keeping that session locally.

The skill tells the agent to treat a timeout or unclear result as unknown. In that case the agent should check the Baijiahao backend rather than retry, because a retry could post the video twice. Only treat a publish as successful when the command or the platform gives clear evidence of submission.

• Keep the saved session on a machine you control
• Review account, file, title, copy and tags before every publish
• Check the Baijiahao backend after any timeout instead of re-running the upload

Tips for using the skill well

Run check before a batch of uploads so you find an expired session early. Use one account alias per Baijiahao account so you do not post to the wrong one. Keep uploads reviewed by a person rather than running them unattended.

• Use consistent account aliases across login, check and upload
• Run upload-video --help when the command options may have changed
• Do not rely on this skill for image posts or scheduled posts; it does not support them