# Send Bluesky to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "bluesky",
    "name": "Bluesky",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/jeffaf/bluesky",
    "canonicalUrl": "https://clawhub.ai/jeffaf/bluesky",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/bluesky",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bluesky",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "requirements.txt",
      "scripts/bsky.py",
      "tests/__init__.py",
      "tests/conftest.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "bluesky",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T15:38:58.885Z",
      "expiresAt": "2026-05-07T15:38:58.885Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bluesky",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bluesky",
        "contentDisposition": "attachment; filename=\"bluesky-1.6.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "bluesky"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/bluesky"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/bluesky",
    "downloadUrl": "https://openagent3.xyz/downloads/bluesky",
    "agentUrl": "https://openagent3.xyz/skills/bluesky/agent",
    "manifestUrl": "https://openagent3.xyz/skills/bluesky/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/bluesky/agent.md"
  }
}
```
## Documentation

### Bluesky CLI

Full-featured CLI for Bluesky/AT Protocol.

### Agent Instructions

First: Check if logged in

bsky whoami

If shows handle → ready to use commands below
If "Not logged in" → guide user through Setup section

Common tasks:

"Post to Bluesky" → bsky post "text"
"Check my timeline" → bsky timeline
"Like this post" → bsky like <url>
"Follow someone" → bsky follow @handle

### Setup

If user isn't logged in (bsky whoami shows "Not logged in"), guide them through setup:

### Getting an App Password

Tell the user:

Go to bsky.app → click your avatar → Settings → Privacy and Security → App Passwords → Add App Password. Name it "OpenClaw" and copy the password (like xxxx-xxxx-xxxx-xxxx). You'll only see it once!

### Logging In

Once they have the app password, run:

bsky login --handle THEIR_HANDLE.bsky.social --password THEIR_APP_PASSWORD

Example:

bsky login --handle alice.bsky.social --password abcd-1234-efgh-5678

Security: Password is used once to get a session token, then immediately discarded. Never stored on disk. Session auto-refreshes.

### Quick Reference

ActionCommandView timelinebsky timeline or bsky tlPostbsky post "text"Post with imagebsky post "text" --image photo.jpg --alt "description"Replybsky reply <url> "text"Quote-postbsky quote <url> "text"View threadbsky thread <url>Create threadbsky create-thread "Post 1" "Post 2" "Post 3" or bsky ctLikebsky like <url>Repostbsky repost <url>Followbsky follow @handleBlockbsky block @handleMutebsky mute @handleSearchbsky search "query"Notificationsbsky notifications or bsky nDelete postbsky delete <url>

### Timeline

bsky timeline              # 10 posts
bsky timeline -n 20        # 20 posts
bsky timeline --json       # JSON output

### Posting

bsky post "Hello world!"                           # Basic post
bsky post "Check this!" --image pic.jpg --alt "A photo"  # With image
bsky post "Test" --dry-run                         # Preview only

### Reply & Quote

bsky reply <post-url> "Your reply"
bsky quote <post-url> "Your take on this"

### Thread View

bsky thread <post-url>           # View conversation
bsky thread <url> --depth 10     # More replies
bsky thread <url> --json         # JSON output

### Create Thread

bsky create-thread "First post" "Second post" "Third post"   # Create a thread
bsky ct "Post 1" "Post 2" "Post 3"                           # Short alias
bsky create-thread "Hello!" "More thoughts" --dry-run         # Preview only
bsky create-thread "Look!" "Nice" --image pic.jpg --alt "A photo"  # Image on first post

### Engagement

bsky like <post-url>             # ❤️ Like
bsky unlike <post-url>           # Remove like
bsky repost <post-url>           # 🔁 Repost (aliases: boost, rt)
bsky unrepost <post-url>         # Remove repost

### Social Graph

bsky follow @someone             # Follow user
bsky unfollow @someone           # Unfollow user
bsky profile @someone            # View profile
bsky profile --json              # JSON output

### Moderation

bsky block @someone              # 🚫 Block user
bsky unblock @someone            # Unblock
bsky mute @someone               # 🔇 Mute user
bsky unmute @someone             # Unmute

### Search & Notifications

bsky search "query"              # Search posts
bsky search "topic" -n 20        # More results
bsky notifications               # Recent notifications
bsky n -n 30                     # More notifications

### Delete

bsky delete <post-url>           # Delete your post
bsky delete <post-id>            # By ID

### JSON Output

Add --json to read commands for structured output:

bsky timeline --json
bsky search "topic" --json
bsky notifications --json
bsky profile @someone --json
bsky thread <url> --json

### Error Handling

ErrorFix"Session expired"Run bsky login again"Not logged in"Run bsky login --handle ... --password ..."Post is X chars (max 300)"Shorten text"Image too large"Use image under 1MB

### Notes

All <url> parameters accept either https://bsky.app/... URLs or at:// URIs
Handles auto-append .bsky.social if no domain specified
Image posts require --alt for accessibility (Bluesky requirement)
Session tokens auto-refresh; password never stored
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: jeffaf
- Version: 1.6.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T15:38:58.885Z
- Expires at: 2026-05-07T15:38:58.885Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/bluesky)
- [Send to Agent page](https://openagent3.xyz/skills/bluesky/agent)
- [JSON manifest](https://openagent3.xyz/skills/bluesky/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/bluesky/agent.md)
- [Download page](https://openagent3.xyz/downloads/bluesky)