post-bluesky

name	post-bluesky
type	python
description	Post to Bluesky (AT Protocol). Body from target/value. Returns confirmation Note with post URI in metadata.
schema_hint	{"target":"$variable (post body from prior step, optional)","value":"string (literal post body, optional)","tags":"string or list (optional): comma-separated tags or list, e.g. 'AI,research' or ['AI','research']","out":"$variable (optional)"}

post-bluesky

Post a text message to Bluesky using the AT Protocol. The post body comes from target (a Note or Collection from a prior step) or value (literal text). Returns a confirmation Note with the post URI and CID in metadata.

Input

Body content (one of):

• target: Variable or resource ID — content becomes the post body (plain text)
• value: Literal string — used as the post body directly

Optional:

• tags: Hashtags to append to the post. Either a comma-separated string ("AI,research") or a list (["AI", "research"]). Tags are appended as #AI #research and linked as clickable Bluesky tags.

Output

Success (status: "success"):

• resource_id: Note ID containing confirmation text (e.g., "Posted to Bluesky: Hello world...").
• Metadata (accessible via get-metadata): uri, cid, timestamp.

Failure (status: "failed"):

• reason: Error description (e.g., BLUESKY_ACCOUNT_HANDLE and BLUESKY_APP_PASSWORD environment variables required, authentication_failed)

Requirements

• BLUESKY_ACCOUNT_HANDLE — Bluesky handle (e.g., alice.bsky.social)
• BLUESKY_APP_PASSWORD — App Password from Bluesky Settings > App Passwords

Behavior

• Authenticates via com.atproto.server.createSession to obtain an access token
• Creates a post via com.atproto.repo.createRecord
• Posts as plain text (UTF-8) with optional hashtag facets
• Post text is truncated at 294 characters (+ "..." if truncated) to stay within Bluesky's 300 grapheme limit
• Tags are appended after the body and linked as clickable hashtags via AT Protocol facets

Common Workflows

Post a simple status update with tags:

{"type":"post-bluesky","value":"Just deployed a new feature! Everything is running smoothly.","tags":"devops,shipping","out":"$posted"}

Post a generated summary:

{"type":"generate-note","prompt":"Write a short tweet-length summary of today's progress","out":"$update"}
{"type":"post-bluesky","target":"$update","out":"$posted"}

Post synthesized research:

{"type":"search-web","query":"latest developments in AI safety 2026","out":"$research"}
{"type":"synthesize","target":"$research","focus":"one key takeaway","format":"brief","out":"$summary"}
{"type":"post-bluesky","target":"$summary","out":"$posted"}