Home / Claude Code / Bluesky
Claude Code + Bluesky Skill

Claude Code + Bluesky Post to the Decentralized Web with AI

Use the Upload-Post skill to publish text posts, photos, and videos to Bluesky directly from Claude Code. Leverage the AT Protocol for decentralized social publishing with automatic link card previews and rich media support.

Get Started Free View Docs

Install in Seconds

Works with Claude Code, Cursor, Windsurf, and any AI coding agent that supports skills.

Terminal
$ npx skills add Upload-Post/upload-post-skill

What You Can Post to Bluesky

Videos
Photos
Text

Features for Bluesky

Everything you need to publish and automate Bluesky content from your terminal.

Text Posts

Publish text posts up to 300 characters on Bluesky with full Unicode support. Mentions and hashtags are automatically detected and converted to proper AT Protocol facets.

Photo Posts

Upload and attach images to your Bluesky posts. Photos are processed and optimized for the platform, supporting JPEG, PNG, and WebP formats with automatic resizing.

Video Posts

Share video content natively on Bluesky. Upload videos that play inline in the feed, reaching your audience with engaging multimedia content directly from Claude Code.

Link Card Previews

URLs included in your posts are automatically resolved into rich link card previews with titles, descriptions, and thumbnail images. No manual configuration required.

AT Protocol Native

Built on the AT Protocol, the open standard powering Bluesky. Your content is published through the decentralized network, giving you full data ownership and portability.

Growing Community Reach

Tap into Bluesky's rapidly expanding user base of developers, creators, and tech enthusiasts. Establish your presence early on the platform where the developer community is migrating.

How It Works

1

Install the Skill

Run the install command in your terminal. The skill is added to Claude Code instantly.

2

Connect Bluesky

Link your Bluesky account on the Upload-Post dashboard and create a profile with your API key.

3

Publish from Claude Code

Tell your AI agent to post content to Bluesky. It handles formatting, uploading, and publishing automatically.

Start Posting to Bluesky from Claude Code

Join thousands of developers automating their social media workflow with AI. Free plan available.

Create Free Account View on GitHub

Also Works With

One skill, 10 platforms. The same install command covers your entire social media stack.

TikTok Instagram YouTube LinkedIn Facebook X Threads Pinterest Reddit

Frequently Asked Questions

How does posting to a decentralized platform like Bluesky work through Claude Code?
Upload-Post handles all the AT Protocol complexity behind a simple API. When you tell Claude Code to post to Bluesky, the skill sends your content to the Upload-Post API, which authenticates with your Bluesky account and publishes through the AT Protocol. Your post appears on Bluesky just as if you published it from the official app.
What media formats does the Bluesky integration support?
Bluesky through Upload-Post supports text posts, photo posts (JPEG, PNG, WebP), and video posts. Images are automatically resized to meet Bluesky's requirements. You can attach media to any text post, and URLs in your text are automatically converted to rich link card previews with thumbnails.
Are link previews generated automatically for Bluesky posts?
Yes. When your post text contains a URL, Upload-Post automatically fetches the page metadata and generates a rich link card preview with the page title, description, and thumbnail image. This works for any publicly accessible URL and is handled server-side before publishing to Bluesky.
What is the character limit for Bluesky posts created through Claude Code?
Bluesky posts have a 300-character limit, which is enforced by the AT Protocol. Upload-Post validates your content length before submission. If your text exceeds the limit, the API returns a clear error so you can shorten the message. Mentions and links count toward the character limit.
Can I cross-post to Bluesky and other platforms simultaneously?
Yes. Upload-Post supports multi-platform publishing in a single API call. Include multiple platforms in your request, such as platform[]=bluesky&platform[]=x&platform[]=threads, and your content is published to all of them simultaneously. Each platform receives properly formatted content that respects its specific requirements.