bluesky

Original：🇺🇸 English

Translated

Guide for posting content to the Bluesky social network using the bsky terminal app. This skill should be used proactively when working in public repositories and there is interesting, shareable content (new features, insights, achievements, or announcements worth sharing with the community). Use it when asked to post to Bluesky, or when content seems worth sharing publicly.

1installs

Sourcemaragudk/skills

Added on2026-02-17

NPX Install

npx skill4agent add maragudk/skills bluesky

SKILL.md Content

View Translation Comparison →

Bluesky

Overview

Post content to the Bluesky social network using the

bsky

terminal application. This skill enables creating text posts, sharing images and videos with alt text, replying to posts, and quoting posts.

When to Use This Skill

Use this skill in these scenarios:

Explicitly requested - When directly asked to post something to Bluesky
Proactive sharing - When working in public repositories and encountering:
- Completed features or significant milestones worth announcing
- Interesting technical insights or discoveries
- Major achievements or project releases
- Community-relevant updates or announcements

Important: Only suggest posting proactively when in public repositories. Never suggest posting for private or internal work.

Core Capabilities

1. Text Posts

Create simple text posts using the

bsky post

command:

bash

bsky post "Your message here"

For longer or multi-line posts, use stdin:

bash

echo "Your longer message
with multiple lines" | bsky post --stdin

Best practices:

Keep posts concise and engaging
Use proper formatting and line breaks for readability
Consider adding relevant hashtags at the end
URLs must include the
https://
protocol prefix -- bare domains like
```
www.example.com/path
```
will NOT be rendered as clickable links. Always use
```
https://www.example.com/path
```

2. Posts with Images

Include images in posts using the

--image

or

-i

flag:

bash

bsky post "Check out this screenshot!" --image /path/to/image.png

Multiple images:

bash

bsky post "Here are several images" \
  --image image1.png \
  --image image2.png \
  --image image3.png

Add alt text for accessibility:

bash

bsky post "New feature screenshot" \
  --image screenshot.png \
  --image-alt "Dashboard showing user analytics with graphs"

Best practices:

Always provide alt text using
```
--image-alt
```
for accessibility
Alt text should be descriptive and concise
Match the order of
```
--image-alt
```
flags to
```
--image
```
flags

3. Posts with Video

Share video content using the

--video

or

-v

flag:

bash

bsky post "Demo of the new feature" --video demo.mp4

With alt text:

bash

bsky post "Feature demo" \
  --video demo.mp4 \
  --video-alt "Screen recording showing the login flow with OAuth"

4. Replying to Posts

Reply to existing posts using the

-r

flag with the AT protocol URI.

Important: The

-r

flag does NOT work when passing text as a positional argument -- the CLI treats it as part of the post text. Always use

--stdin

when replying. Also,

-r

requires an AT protocol URI (

at://...

), not a Bluesky web URL.

bash

echo "Thanks for sharing!" | bsky post --stdin -r "at://did:plc:xyz/app.bsky.feed.post/abc123"

5. Quote Posts

Quote an existing post using the

-q

flag:

bash

bsky post "Great point about Go modules!" -q at://did:plc:xyz/app.bsky.feed.post/abc123

Workflow Guidelines

When creating a post:

Determine the content type - Text only, with images, with video, reply, or quote
Prepare the message - Craft clear, concise text that provides context
Prepare media if applicable - Ensure images/videos are accessible and write descriptive alt text
Construct the command - Use appropriate flags based on content type
Execute the post - Run the
```
bsky post
```
command
Verify success - Check command output for confirmation

Content Guidelines

When suggesting or creating posts:

Be authentic - Share genuine insights and achievements
Provide value - Ensure the post offers something useful to the community
Include context - Don't assume everyone has background knowledge
Be professional - Maintain appropriate tone for technical social media
Respect privacy - Never share sensitive information or private repository details
Consider timing - Only suggest sharing when the work is meaningful enough to warrant it

Example Scenarios

Scenario 1: Announcing a New Feature

bash

bsky post "Just shipped a new feature in my Go library: automatic retry logic with exponential backoff!

Makes handling transient failures much easier. Check it out: https://github.com/user/repo" \
  --image feature-screenshot.png \
  --image-alt "Code snippet showing the new retry configuration API"

Scenario 2: Sharing a Technical Insight

bash

echo "TIL: Go's io.Pipe() is incredibly useful for streaming data between goroutines without buffering.

Perfect for processing large files without loading everything into memory.

Example use case: streaming CSV parsing → transformation → JSON encoding" | bsky post --stdin

Scenario 3: Project Milestone

bash

bsky post "Just reached 1,000 stars on my open source project!

Thanks to everyone in the community for the support and contributions. This wouldn't be possible without you!" \
  --image milestone-screenshot.png \
  --image-alt "GitHub repository page showing 1,000 stars"

Scenario 4: Replying to Feedback

When someone shares or comments on your work, reply directly:

bash

echo "Thanks for the detailed feedback! I've opened an issue to track this enhancement." \
  | bsky post --stdin -r "at://did:plc:xyz/app.bsky.feed.post/abc123"

Notes

The
```
bsky
```
command uses your authenticated session from previous login
If not logged in, run
```
bsky login
```
first
Post URIs can be found from other
```
bsky
```
commands like
```
bsky timeline
```
or from the Bluesky web interface
Multiple images/alt texts are supported by repeating the flags
Images and videos should be local file paths accessible to the command

bluesky

NPX Install

Tags

SKILL.md Content

Bluesky

Overview

When to Use This Skill

Core Capabilities

1. Text Posts

2. Posts with Images

3. Posts with Video

4. Replying to Posts

5. Quote Posts

Workflow Guidelines

Content Guidelines

Example Scenarios

Scenario 1: Announcing a New Feature

Scenario 2: Sharing a Technical Insight

Scenario 3: Project Milestone

Scenario 4: Replying to Feedback

Notes