How do I install the Bluesky Reader skill?

Run npx skillmds add majiayu000/bluesky-reader 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.

What does the Bluesky Reader skill do?

Read public Bluesky feeds via AT Protocol API. It is listed under Integrations & APIs on SkillMD.

Is Bluesky Reader safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bluesky Reader?

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 Reader free to use?

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

Who published Bluesky Reader?

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

Bluesky Reader by majiayu000 — Agent Skill

Name: Bluesky Reader
Rating: 4.2 (5 reviews)
Author: majiayu000

File contents

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 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

---name: bluesky-readerdescription: Read public Bluesky feeds via AT Protocol API.--- # 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 |

Frequently asked questions