Publish Social — Communication skill for Claude Code

publish-social

Publish one Markdown post to **Bluesky, Mastodon, Threads, LinkedIn, X, Instagram, Facebook, and YouTube (Shorts)** with a single command. Write the post once (one fenced block per platform, one optional image or video), preview exactly what will go out, then post everywhere and get the links written back into the file.

Works both as a **Claude Code skill** and as a **standalone command-line tool**. This guide assumes you have never done any of this before and walks every step.

Platforms at a glance

Platform	Cost	Media	How hard to set up
Bluesky	Free	Direct upload	Easiest (~5 min)
Mastodon	Free	Direct upload	Easy
LinkedIn	Free	Direct upload	Needs a one-time API approval (days to weeks)
Threads	Free	Fetched from a public URL	Most involved (a browser OAuth flow)
X / Twitter	Paid API (~$0.015/post, $0.20 with a link) — or free via a logged-in browser	Direct upload	Moderate (API), or a one-time browser login (free)
Instagram	Free	Fetched from a public URL	Hard: needs a Business account + Meta App Review
Facebook	Free	Fetched from a public URL	Moderate: a Page you admin; non-expiring token
YouTube	Free	Direct upload (video required)	Moderate: a Google Cloud OAuth app

Each post carries **one image or one video** (never both). You do not need all eight platforms; set up only the ones you want, and the rest are skipped automatically. Instagram has an extra gate (App Review) described in its section. **YouTube is video-only** — it publishes the post's video as a Short, so it's only offered when the post has a `video:`.

Contents

1. How it works
2. Install the prerequisites
3. Get publish-social
4. Create your credentials file
5. Connect your platforms
   • Bluesky