🦋 Bluesky Skill

A Bot skill for interacting with Bluesky (AT Protocol) from the command line.

Features

  • Timeline - View your home feed
  • Post - Create new posts
  • Search - Search posts across Bluesky
  • Notifications - Check likes, reposts, follows, mentions
  • Profile - Look up user profiles

Setup

1. Get an App Password

  1. Go to bsky.app → Settings → Privacy and Security → App Passwords
  2. Create a new app password (looks like xxxx-xxxx-xxxx-xxxx)

2. Login

bsky login --handle yourhandle.bsky.social --password xxxx-xxxx-xxxx-xxxx

Credentials are stored in ~/.config/bsky/config.json.

3. Verify

bsky whoami

Usage

# Timeline
bsky timeline          # Show 10 posts
bsky tl -n 20          # Show 20 posts

# Post
bsky post "Hello Bluesky!"
bsky p "Short post"    # Alias

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

# Notifications  
bsky notifications
bsky notif -n 30

# Profile
bsky profile                        # Your profile
bsky profile @someone.bsky.social   # Someone else's

Output Format

@handle · Jan 25 14:30
  Post text here...
  ❤️ 42  🔁 5  💬 3
  🔗 https://bsky.app/profile/handle/post/id

Requirements

  • Python 3.8+
  • atproto package (auto-installed on first run)

Installation

Via Skills:

skills install bluesky

License

MIT


Built for Bot

S
Description
Hanzo Bot skill: bluesky (by jeffaf)
Readme
29 KiB
Languages
Python 100%