How do I install the Bluesky skill?

Run npx skillmds@latest add danstrem2/bluesky in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Bluesky safe to use?

SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bluesky?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Bluesky free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Bluesky?

danstrem2 (@danstrem2) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Bluesky by danstrem2 — Agent Skill

Name: Bluesky
Rating: 4.2 (5 reviews)
Author: danstrem2

Bluesky

Read, post, and interact with Bluesky (AT Protocol) via CLI. Use when user asks to check Bluesky, post to Bluesky, view their Bluesky timeline, search Bluesky, or check Bluesky notifications. Supports timeline, posting, profile lookup, search, and notifications.

danstrem2 Updated Aug 19, 2026 2 repo stars

File contents

Bluesky CLI

Interact with Bluesky/AT Protocol from the command line.

Setup

First-time setup requires an app password from Bluesky:

Go to bsky.app → Settings → Privacy and Security → App Passwords
Create a new app password
Run: bsky login --handle yourhandle.bsky.social --password xxxx-xxxx-xxxx-xxxx

Security: Password is NOT stored. The CLI exports a session token on login, which auto-refreshes. Your app password only exists in memory during login.

Commands

# Authentication
bsky login --handle user.bsky.social --password xxxx-xxxx-xxxx-xxxx
bsky whoami

# Timeline
bsky timeline              # Show home feed (10 posts)
bsky timeline -n 20        # Show 20 posts
bsky tl                    # Alias

# Posting
bsky post "Hello world!"   # Create a post
bsky p "Short post"        # Alias
bsky post "Test" --dry-run # Preview without posting

# Version
bsky --version             # Show version

# Delete
bsky delete <post_id>      # Delete a post by ID or URL
bsky rm <url>              # Alias

# Profiles
bsky profile               # Your profile
bsky profile @someone.bsky.social

# Search
bsky search "query"        # Search posts
bsky search "offsec" -n 20

# Notifications
bsky notifications         # Likes, reposts, follows, mentions
bsky notif -n 30           # Alias with count

Output Format

Timeline and search results show:

@handle · Jan 25 14:30
  Post text (truncated to 200 chars)
  ❤️ likes  🔁 reposts  💬 replies
  🔗 https://bsky.app/profile/handle/post/id

Installation

The skill uses a Python virtual environment. On first run:

cd {baseDir}/scripts
python3 -m venv venv
./venv/bin/pip install atproto

Then run commands via:

{baseDir}/scripts/venv/bin/python {baseDir}/scripts/bsky.py [command]

Or use the wrapper script:

{baseDir}/scripts/bsky [command]

---name: blueskydescription: Read, post, and interact with Bluesky (AT Protocol) via CLI. Use when user asks to check Bluesky, post to Bluesky, view their Bluesky timeline, search Bluesky, or check Bluesky notifications. Supports timeline, posting, profile lookup, search, and notifications.---# Bluesky CLIInteract with Bluesky/AT Protocol from the command line.## SetupFirst-time setup requires an app password from Bluesky:1. Go to bsky.app → Settings → Privacy and Security → App Passwords2. Create a new app password3. Run: `bsky login --handle yourhandle.bsky.social --password xxxx-xxxx-xxxx-xxxx`**Security:** Password is NOT stored. The CLI exports a session token on login, which auto-refreshes. Your app password only exists in memory during login.## Commands```bash# Authenticationbsky login --handle user.bsky.social --password xxxx-xxxx-xxxx-xxxxbsky whoami# Timelinebsky timeline # Show home feed (10 posts)bsky timeline -n 20 # Show 20 postsbsky tl # Alias# Postingbsky post "Hello world!" # Create a postbsky p "Short post" # Aliasbsky post "Test" --dry-run # Preview without posting# Versionbsky --version # Show version# Deletebsky delete <post_id> # Delete a post by ID or URLbsky rm <url> # Alias# Profilesbsky profile # Your profilebsky profile @someone.bsky.social# Searchbsky search "query" # Search postsbsky search "offsec" -n 20# Notificationsbsky notifications # Likes, reposts, follows, mentionsbsky notif -n 30 # Alias with count```## Output FormatTimeline and search results show:```@handle · Jan 25 14:30 Post text (truncated to 200 chars) ❤️ likes 🔁 reposts 💬 replies 🔗 https://bsky.app/profile/handle/post/id```## InstallationThe skill uses a Python virtual environment. On first run:```bashcd {baseDir}/scriptspython3 -m venv venv./venv/bin/pip install atproto```Then run commands via:```bash{baseDir}/scripts/venv/bin/python {baseDir}/scripts/bsky.py [command]```Or use the wrapper script:```bash{baseDir}/scripts/bsky [command]```

Frequently asked questions