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.
Install in Seconds
$ npx skills add Upload-Post/upload-post-skill Works with Claude Code, Cursor, Windsurf, and any AI coding agent that supports skills.
What You Can Post to Bluesky
Just Tell Your Agent
Once you've installed the skill and set your API key, simply ask Claude Code in plain English. No API calls needed.
✓ Post published to Bluesky with link preview
Post URL: https://bsky.app/profile/yourhandle/post/...
Features for Bluesky
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
Install the Skill
Run the install command in your terminal. The skill is added to Claude Code instantly.
Connect Bluesky
Link your Bluesky account on the Upload-Post dashboard and create a profile with your API key.
Publish from Claude Code
Tell your AI agent to post content to Bluesky. It handles formatting, uploading, and publishing automatically.
Also Works With
Frequently Asked Questions
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.
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.
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.
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.
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.
Start Posting to Bluesky from Claude Code
Join thousands of developers automating their social media workflow with AI. Free plan available.