---
name: notque-bluesky-reader
description: "Read public Bluesky feeds via AT Protocol API."
license: "MIT"
metadata:
  decimalai-skill-id: "1a696cc8-3e2b-4f88-9cf4-009e333bbd28"
  decimalai-version-id: "dcfee03d-4b8c-40e7-8db8-77661dc565e0"
  decimalai-version: "1"
  decimalai-body-sha256: "874ff584a3ca0ae6b2d436aef70b7b8f08d684975650f03172e5ee46f0111570"
  decimalai-name: "notque/bluesky-reader"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "research"
  decimalai-source: "https://app.decimal.ai/s/notque-bluesky-reader@1/SKILL.md"
---
# Bluesky Reader Skill

Read public Bluesky profiles via the AT Protocol public API. No auth needed.

## Commands

```bash
# Fetch recent posts
python3 ~/.claude/scripts/bluesky_reader.py feed --handle HANDLE --limit 20

# Search posts by keyword (fetches feed, filters locally)
python3 ~/.claude/scripts/bluesky_reader.py search --handle HANDLE --query "search terms"

# JSON output for pipeline consumption
python3 ~/.claude/scripts/bluesky_reader.py feed --handle HANDLE --json

# Pagination
python3 ~/.claude/scripts/bluesky_reader.py feed --handle HANDLE --cursor CURSOR_STRING
```

## API Details

- **Endpoint**: `https://public.api.bsky.app/xrpc/app.bsky.feed.getAuthorFeed`
- **Auth**: None (public endpoint)
- **Limit**: 1-100 posts per request
- **Search**: Local keyword filter -- all query words must appear (case-insensitive)

## When to Use

- Gathering recent Bluesky posts from a specific person for research
- Searching a profile's posts for mentions of a topic
- Feeding Bluesky content into a news or content pipeline

## Reference Loading

| Task type | Load this reference |
|-----------|-------------------|
| Endpoint details, data shapes, pagination | `references/at-protocol-api.md` |
| Debugging fetch errors, wrong output, missing posts | `references/at-protocol-preferred-patterns.md` |
| Extending the script with new endpoints or search | `references/at-protocol-api.md` |
| Code review of AT Protocol Python code | `references/at-protocol-preferred-patterns.md` |

## Exit Codes

| Code | Meaning |
|------|---------|
| 0    | Success |
| 1    | Error (network failure, invalid handle, no posts found) |

## Reference Loading Table

| Signal | Load These Files | Why |
|---|---|---|
| Endpoint details, data shapes, pagination | `at-protocol-api.md` | Routes to the matching deep reference |
| Debugging fetch errors, wrong output, missing posts | `at-protocol-preferred-patterns.md` | Routes to the matching deep reference |
| Extending the script with new endpoints or search | `at-protocol-api.md` | Routes to the matching deep reference |
| Code review of AT Protocol Python code | `at-protocol-preferred-patterns.md` | Routes to the matching deep reference |