Best use case
bluesky-reader is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Read public Bluesky feeds via AT Protocol API.
Teams using bluesky-reader should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/bluesky-reader/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How bluesky-reader Compares
| Feature / Agent | bluesky-reader | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Read public Bluesky feeds via AT Protocol API.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# 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 ## Exit Codes | Code | Meaning | |------|---------| | 0 | Success | | 1 | Error (network failure, invalid handle, no posts found) |
Related Skills
x-api
Post tweets, build threads, upload media via the X API.
worktree-agent
Mandatory rules for agents in git worktree isolation.
workflow
Structured multi-phase workflows: review, debug, refactor, deploy, create, research, and more.
workflow-help
Interactive guide to workflow system: agents, skills, routing, execution patterns.
wordpress-uploader
WordPress REST API integration for posts and media uploads.
wordpress-live-validation
Validate published WordPress posts in browser via Playwright.
with-anti-rationalization
Anti-rationalization enforcement for maximum-rigor task execution.
voice-writer
Unified voice content generation pipeline with mandatory validation and joy-check. 8-phase pipeline: LOAD, GROUND, GENERATE, VALIDATE, REFINE, JOY-CHECK, OUTPUT, CLEANUP. Use when writing articles, blog posts, or any content that uses a voice profile. Use for "write article", "blog post", "write in voice", "generate content", "draft article", "write about".
voice-validator
Critique-and-rewrite loop for voice fidelity validation.
vitest-runner
Run Vitest tests and parse results into actionable output.
video-editing
Video editing pipeline: cut footage, assemble clips via FFmpeg and Remotion.
verification-before-completion
Defense-in-depth verification before declaring any task complete.