Skip to content

Guide · Agent skill

How to use the social-auto-upload multi-platform publisher skill

Updated · written with AI from the project's own documentation and checked against our catalogue data

social-auto-upload is an agent skill that acts as the entry point for publishing videos, articles and image-text posts to social platforms supported by the social-auto-upload repository. This guide explains what the skill makes your agent do, how to install it, how to ask for things in plain language, and what to check before anything goes live. You do not need prior experience with agent skills to follow it.

social-auto-upload Multi-Platform Publisherdreammis/social-auto-upload · MIT

Quick start

  1. 1Get the skill. Download the ZIP from this page, or run the npx skills add command from the repository. Unzip into ~/.claude/skills/ or a project's .claude/skills/ folder.
  2. 2Install the sau tool. Follow the GitHub repository README to install the sau command-line tool, since the skill file does not list those steps.
  3. 3Check the platform help. Run sau followed by the platform name and --help to see the current arguments before any publishing command.
  4. 4Log in on the platform. Complete the login yourself on the platform's page. Do not share your password with the agent.
  5. 5Ask for the publish in plain language. Name the content, the platforms, the account and the publishing method. Review the checklist the agent shows before approving the post.

What the social-auto-upload skill does

The skill is a router. When you ask to publish content, the agent first confirms the platform, content type, account alias and publishing method you want. If you do not name a target platform, the agent asks rather than choosing one itself.

After that, the skill points the agent to the matching platform-specific skill (for example douyin-upload, bilibili-upload or youtube-upload) and to the sau command-line tool, which uses the platform name as its argument. The skill lists platforms including Douyin, Bilibili, Xiaohongshu, Kuaishou, WeChat Channels, Baijiahao, Weibo, YouTube, Zhihu, Facebook, Instagram and others.

  • Douyin (douyin-upload, CLI name douyin)
  • Bilibili (bilibili-upload, bilibili)
  • Xiaohongshu (xiaohongshu-upload, xiaohongshu)
  • YouTube (youtube-upload, youtube)
  • Zhihu (zhihu-upload, zhihu)
  • Instagram (instagram-upload, instagram)
  • TikTok (tiktok-upload, no sau command; it must go through its own skill)

Install the social-auto-upload skill

Option 1: download the ZIP for this skill from this page and unzip it into ~/.claude/skills/ for all your projects, or into a project's .claude/skills/ folder to limit it to that project.

Option 2: in the Claude apps, open Settings, go to Capabilities, then Skills, and upload the skill there.

If you work from the command line, the source file names the following install command for the entry skill. Replace social-auto-upload with a platform skill name from the table if you only need one platform.

npx skills add dreammis/social-auto-upload --skill social-auto-upload

Install the sau tool and platform logins

The skill tells the agent to run sau <platform> --help before using any command, so the agent can confirm the current arguments. The skill file does not list the install steps for sau, so check the GitHub repository README and distribution documentation for setup.

Each platform needs its own login. The skill tells the agent to check account status first and to hand login over to you when it must be completed on the platform's page. The agent is not supposed to ask for or store your password.

sau <platform> --help

How to trigger the skill with natural requests

You do not need a special command. Describe the content, the platforms and the account in one message. The skill is meant to trigger when you want to publish videos, articles or image-text posts on supported platforms, or distribute content to several named platforms.

Good requests name everything the agent needs to ask about less. Vague requests like post this everywhere will prompt questions before anything happens.

  • Publish final.mp4 to Douyin and Bilibili using my main account, title it with the file's topic, and show me the draft before posting.
  • Send this article to Zhihu and Baijiahao. Use the account alias work-blog.
  • Post these images to Xiaohongshu as an image-text note, schedule it for later and confirm the time with me first.
  • Which platform skill should I use for Instagram Reels from this video?

What the agent checks before posting

The skill sets a checklist. Before posting, the agent should verify the files, title, copy, tags, visibility, schedule and target account for each platform. Requirements can differ between platforms, so the same content is checked separately for each one.

The agent should only report a post as published when the command or platform gives evidence that this specific submission succeeded. If a request times out or the result is unclear, the skill tells the agent to check the original post first rather than sending it again.

  • Confirm the platform, content type, account and publishing method.
  • Check that the account is logged in.
  • Review files, title, body, tags, visibility and schedule.
  • Post only to platforms you named.
  • Treat unclear results as unknown and check before retrying.

Safety notes: scripts and network access

This skill runs scripts and uses the network. Its job is to drive uploads to real public accounts, so review the steps the agent plans to take before approving them. The skill itself requires confirmation of each target platform and content detail.

Use the skill only with accounts you own or control. Automating logins and uploads can breach a platform's terms and the rights of the account holder. Posting to public accounts is also hard to undo.

  • Do not give the agent your platform passwords; complete logins yourself on the platform page.
  • Keep the skill's confirmation steps in place rather than asking for fully automatic posting.
  • Read the GitHub repository's documentation for each platform before first use.

Tips for using the skill well

Keep one account alias per platform so the agent can target the right account without guessing. Name the platforms explicitly every time, because the skill will not pick them for you.

If you only need one platform, install its dedicated skill directly with the --skill option, using the name from the platform table. For TikTok, use its separate skill, since the CLI has no TikTok command.

  • Start with a draft or private visibility while you test a new workflow, if the platform supports it.
  • Ask the agent to show the final checklist before it posts.
  • Keep the source files and final copy in one folder so the agent can confirm them.

What people use it for

  • Posting the same finished video to Douyin, Bilibili and YouTube with platform-specific titles and tags.
  • Publishing a long-form article to Zhihu and other article platforms from one request.
  • Sending image-text notes to Xiaohongshu or Instagram while checking the copy and tags first.
  • Scheduling a post for later and confirming the time with you before it is submitted.
  • Finding out which platform-specific skill to use for a given platform and content type.

Frequently asked questions

Is the social-auto-upload skill free?

The skill is listed under the MIT licence on this page. The SKILL.md file's frontmatter names MIT-0, so check the repository's licence file if you need to confirm which terms apply to your use.

How do I install the social-auto-upload skill?

Download the ZIP from this page and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder. In the Claude apps, you can also upload it under Settings, then Capabilities, then Skills. Command-line users can run npx skills add dreammis/social-auto-upload --skill social-auto-upload.

What do I need before the skill can post anything?

You need the social-auto-upload repository or the individual platform skills, the sau command-line tool with its per-platform login, and accounts on the platforms you want to use. You log in to each platform yourself on its page.

Does social-auto-upload work with TikTok?

Not through the sau command. The skill states TikTok has no sau command, so TikTok posting goes through its separate tiktok-upload skill.

Will the agent post automatically without asking me?

No. The skill requires confirmation of each target platform and content detail, and it asks which platform, content type, account and publishing method you want before posting.

What if a post times out or I am not sure it went through?

The skill tells the agent to check the original post first and not to resend it blindly. Only a success result from the command or the platform counts as proof that the post went live.

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 and social media managers who post the same content to several platforms and want a checklist with confirmation steps before anything goes live. It is a poor fit for anyone who wants fully automatic posting without review, wants TikTok through the CLI, or plans to use accounts they do not control.

Download the skill

Find exactly what
you're looking for