bluesky

What This Skill Does

The Bluesky CLI skill transforms your terminal into a full-featured interface for the Bluesky social network and the AT Protocol. It provides seamless interaction with your feed, allowing you to read timelines, craft posts, engage with community content, and manage your social presence without ever leaving your terminal environment. Whether you need to quickly share a status update with an image, reply to ongoing discussions, or perform administrative tasks like blocking or muting users, this skill automates these actions via a robust command-line interface. It is designed for power users, developers, and those who prefer a keyboard-centric workflow over browser-based social media.

Installation

To install this skill, use the ClawHub command-line tool. Run the following command in your terminal:

clawhub install openclaw/skills/skills/bobdevibecoder/bobagent-bluesky

Once installed, you must authenticate. Run bsky whoami to check your status. If you are not logged in, obtain an App Password from the 'Privacy and Security' settings in the Bluesky app. Finally, run the bsky login command with your handle and the newly generated app password.

Use Cases

This skill is ideal for several scenarios. First, it streamlines cross-posting workflows by allowing you to script or manually post updates directly from development environments. Second, it is perfect for users who want to monitor their timeline or mentions using tools like grep or JSON processors to extract specific data. Third, it serves as a robust tool for power users who manage multiple accounts or require rapid, text-based interactions for engagement and community moderation tasks.

Example Prompts

1. "Check my Bluesky timeline and tell me if there is anything from @alice.bsky.social."
2. "Post a new update to my Bluesky profile saying 'Just pushed code using OpenClaw!' and attach the screenshot located at ./logs/screenshot.png."
3. "Find the most recent post by @bob.bsky.social and reply to it saying 'Great work on this update!'"

Tips & Limitations

• Security: Always use App Passwords, never your account password. The skill does not store passwords; it generates session tokens for ongoing access.
• Media: When posting images, ensure the file path is accessible to the agent. Currently, text-based operations are faster than media uploads.
• Limitations: The tool relies on the public AT Protocol API; if the API is rate-limited, the CLI will notify you. Use the --json flag on commands like timeline or profile to pipe output into other utilities like jq for advanced processing.