← Back to Skills Marketplace
6762
Downloads
16
Stars
21
Active Installs
15
Versions
Install in OpenClaw
/install bluesky
Description
Use the Bluesky CLI for timeline, search, notifications, posts, replies, threads, images, likes, reposts, follows, blocks, and mutes.
Usage Guidance
Install only if you want an agent-accessible Bluesky CLI that can post publicly and change your account state. Use a Bluesky app password, revoke it from Bluesky settings if needed, consider enabling BSKY_CONFIRM_MUTATIONS=1 for confirmation prompts, and review targets carefully before delete, follow, block, mute, repost, or similar actions.
Capability Assessment
Purpose & Capability
The skill is a full-featured Bluesky CLI for timelines, search, notifications, posts, replies, threads, likes, reposts, follows, blocks, mutes, and deletion. Those read and mutation capabilities are high impact for a social account but are coherent with the stated purpose and documented in the skill and README.
Instruction Scope
Agent instructions tell the agent to avoid handling app passwords in chat, use dry-run for public posts unless final text is already approved, and verify targets before account-changing actions. The CLI's built-in confirmation prompts are opt-in via BSKY_CONFIRM_MUTATIONS, so safe use depends partly on following those instructions.
Install Mechanism
The wrapper creates a local virtual environment and installs the atproto dependency on first run. This is documented in the README and limited to one declared dependency, but users should understand it performs a package install during first execution.
Credentials
Local file access is limited to the skill's venv, the documented Bluesky config path, and user-supplied image files. Network use is expected for Bluesky/AT Protocol operations.
Persistence & Privilege
The CLI stores a Bluesky session token at ~/.config/bsky/config.json with owner-only permissions and says the app password is not stored. Persistent account access is expected for a CLI but should be treated like a logged-in session.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install bluesky - After installation, invoke the skill by name or use
/bluesky - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.6.3
Security/admin release: backward-compatible safer login guidance, hidden legacy --password help, optional mutation confirmations, README/license/changelog fixes, and cleanup of generated Skill Card metadata.
v1.6.2
Admin metadata update: restore skill-card.md for ClawHub verification while keeping the 1.6.1 security-compatible runtime behavior.
v1.6.1
Security/admin update: safer login guidance, hidden legacy --password help, opt-in mutation confirmations, README accuracy fixes, changelog, and MIT-0 license file.
v1.6.0
Add thread creation command (bsky create-thread / ct)
v1.5.3
Security hardening (config permissions, env var auth), --json on all commands, new stats command, --quiet flag for scripting, normalize_handle helper, unresolved mention warnings
v1.5.2
- Added clear agent instructions for checking login status and guiding initial usage.
- Updated documentation to help users distinguish between logged-in and not-logged-in states.
- Highlighted the most common tasks and their commands for easier onboarding.
- No changes to CLI functionality; documentation only.
v1.5.1
- Internal cleanup: removed CHANGELOG.md and docs/THREADING.md files.
- No user-facing features or command changes.
- Version bump to 1.5.1.
v1.5.0
**Expanded features and improved usability for the Bluesky CLI.**
- Added support for image posts, replies, quote-posts, thread views, likes, reposts, follows, blocks, mutes, and profile lookups.
- Introduced JSON output option for many commands.
- Improved setup instructions, authentication guidance, and error handling help.
- Extended moderation and engagement commands (block, mute, unlike, unrepost, unfollow, etc.).
- Updated documentation and included concise command reference tables.
- New changelog file added.
v1.2.0
logout command, mention facets, config security (chmod 600), pinned atproto version, Moltbot rebrand
v1.1.0
Bluesky CLI 1.1.0 improves authentication security.
- App password is no longer stored; only a session token is saved after login.
- SKILL.md updated to clarify password handling and security details.
- All existing commands and features remain unchanged.
v1.0.4
Fix: bsky profile @handle now auto-appends .bsky.social
v1.0.3
URLs in posts are now auto-detected and clickable
v1.0.2
Added delete command (bsky delete/rm)
v1.0.1
Added README.md
v1.0.0
Initial release: timeline, posting, search, notifications, profile lookup via atproto
Metadata
Frequently Asked Questions
What is Bluesky?
Use the Bluesky CLI for timeline, search, notifications, posts, replies, threads, images, likes, reposts, follows, blocks, and mutes. It is an AI Agent Skill for Claude Code / OpenClaw, with 6762 downloads so far.
How do I install Bluesky?
Run "/install bluesky" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Bluesky free?
Yes, Bluesky is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Bluesky support?
Bluesky is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Bluesky?
It is built and maintained by jeffaf (@jeffaf); the current version is v1.6.3.
More Skills