← Back to Skills Marketplace
Bluesky
by
Heather-Herbert
· GitHub ↗
· v0.1.7
· MIT-0
291
Downloads
0
Stars
0
Active Installs
8
Versions
Install in OpenClaw
/install openclaw-bluesky
Description
Bluesky/AT Protocol orchestration skill for authenticated interaction with the Bluesky Social network: post, reply, like, repost, quote, bookmark, and upload...
Usage Guidance
This skill appears to implement exactly what it claims (authenticated Bluesky posting and media uploads) and asks for a Bluesky app password and handle — which is expected. However, the package/registry metadata omitted those required env vars, so verify before installing: 1) Confirm the platform will prompt you to provide BSKY_APP_PASSWORD and will treat it as a secret (do not paste your primary account password). 2) Review the referenced GitHub repo and the 'atproto' pip package to ensure they are the expected, official implementations (confirm package name, source, and recent activity). 3) Understand that once installed with your app password the skill can post/like/repost as your app; grant only the minimal app-password permissions and rotate/revoke the app password if you remove the skill. 4) If you need higher assurance, ask the maintainer to update the registry metadata to list required env vars/primary credential so the platform can surface permissions correctly.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-bluesky
Version: 0.1.7
The skill is a standard and well-documented implementation for interacting with the Bluesky/AT Protocol social network using the official 'atproto' Python SDK. It follows security best practices by requiring App Passwords instead of primary credentials and correctly identifies secrets in the metadata. No evidence of malicious intent, data exfiltration, or unauthorized code execution was found in lib/bluesky_agent.py or the instructions in SKILL.md.
Capability Assessment
Purpose & Capability
The skill's name, description, SKILL.md, README, and code (lib/bluesky_agent.py) all align: it implements AT Protocol interactions and needs a Bluesky handle, PDS URL, and an App Password. However, the registry metadata at the top of the package declares 'Required env vars: none' and 'Primary credential: none', which contradicts the SKILL.md's declared required environment variables. This mismatch is a packaging/metadata coherence issue.
Instruction Scope
SKILL.md instructions are limited to installing the atproto Python SDK, setting BSKY_PDS/BSKY_HANDLE/BSKY_APP_PASSWORD environment variables, and following AT Protocol practices (resolve handles, use TextEncoder, fetch latest cid). There are no instructions to read unrelated system files or exfiltrate data to third-party endpoints.
Install Mechanism
There is no platform install spec, but the skill's own SKILL.md requests installing the atproto package via pip (pip install atproto). This is a standard package install; no arbitrary URL downloads or archive extraction are present. The included code imports atproto, which matches that install step.
Credentials
The environment variables requested in SKILL.md (BSKY_PDS, BSKY_HANDLE, BSKY_APP_PASSWORD) are appropriate and proportionate for authenticated Bluesky operations. The concern is the package/registry metadata does not list these required env vars or a primary credential, which could cause the platform to not surface the secret requirements properly to users. Confirm the platform will treat BSKY_APP_PASSWORD as a secret and will prompt for it before enabling the skill.
Persistence & Privilege
The skill does not request always:true or other elevated persistent privileges. Default autonomous invocation is allowed (platform default), which is expected for an agent skill that can post on behalf of a user — be aware that if installed with credentials the skill can perform actions (post/like/repost) on your account.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-bluesky - After installation, invoke the skill by name or use
/openclaw-bluesky - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.7
- Added installation instructions for the required Python SDK (`atproto`) in both metadata and setup steps.
- Updated metadata to specify the `atproto` pip dependency for easier installation.
- No changes to skill features or functionality.
v0.1.6
- Added initial documentation: README.md and VERSION_HISTORY.md.
- Introduced main agent implementation file: lib/bluesky_agent.py.
- Establishes the foundation for the Bluesky skill, enabling authenticated operations and future development.
v0.1.5
- Marked BSKY_HANDLE and BSKY_APP_PASSWORD as required in the environment metadata.
- Added a secrets declaration for BSKY_APP_PASSWORD in metadata.
v0.1.4
No changes detected in this version.
- Version 0.1.4 was released with no file or documentation updates.
v0.1.3
- Added structured YAML frontmatter with skill name, description, emoji, and environment variables.
- No changes to core documentation or described features.
v0.1.2
- Expanded documentation to clarify authentication and configuration using environment variables.
- Added provenance and GitHub source link for reference.
- Updated setup instructions to emphasize secure App Password usage.
- Included an Author section with profile link.
- Minor rewording and restructuring of description for clarity and readability.
v0.1.1
- Added detailed setup and authentication instructions, including App Password guidance.
- Expanded capability descriptions with usage notes for threading and embedding.
- Improved implementation notes on handle resolution, rich text facets, and referencing latest post CIDs.
- Linked to official AT Protocol and Bluesky developer documentation.
v0.1.0
Initial release of the openclaw-bluesky skill:
- Provides robust orchestration for the Bluesky/AT Protocol.
- Supports rich text with accurate UTF-8 facet handling.
- Enables threaded replies, media uploads, and bookmark management.
- Includes core actions: post, like, repost, quote, bookmark, and blob upload.
- Resolves user handles to DIDs and validates Lexicon conformance.
Metadata
Frequently Asked Questions
What is Bluesky?
Bluesky/AT Protocol orchestration skill for authenticated interaction with the Bluesky Social network: post, reply, like, repost, quote, bookmark, and upload... It is an AI Agent Skill for Claude Code / OpenClaw, with 291 downloads so far.
How do I install Bluesky?
Run "/install openclaw-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 Heather-Herbert (@heather-herbert); the current version is v0.1.7.
More Skills