Files

1.5 KiB

๐Ÿฆ‹ 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