OpenParable
Skip to content
← Back to skills

Bluesky Reader

Apps & Automation
bluesky-reader

Bluesky Reader is an Agent Skill for apps & automation published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Read public Bluesky feeds via AT Protocol API.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/other/bluesky-reader/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/bluesky-reader, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Bluesky Reader Skill

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

Commands

# 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 typeLoad this reference
Endpoint details, data shapes, paginationreferences/at-protocol-api.md
Debugging fetch errors, wrong output, missing postsreferences/at-protocol-preferred-patterns.md
Extending the script with new endpoints or searchreferences/at-protocol-api.md
Code review of AT Protocol Python codereferences/at-protocol-preferred-patterns.md

Exit Codes

CodeMeaning
0Success
1Error (network failure, invalid handle, no posts found)

Reference Loading Table

SignalLoad These FilesWhy
Endpoint details, data shapes, paginationat-protocol-api.mdRoutes to the matching deep reference
Debugging fetch errors, wrong output, missing postsat-protocol-preferred-patterns.mdRoutes to the matching deep reference
Extending the script with new endpoints or searchat-protocol-api.mdRoutes to the matching deep reference
Code review of AT Protocol Python codeat-protocol-preferred-patterns.mdRoutes to the matching deep reference