notque/bluesky-reader
skills/bluesky-reader/SKILL.md
Read public Bluesky feeds via AT Protocol API.
$ install --global
skillsauthnpx skillsauth add notque/claude-code-toolkit bluesky-readerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 3, 2026, 5:01 AM131.5s4 files scanned
SKILL.md
- name:
- bluesky-reader
- description:
- Read public Bluesky feeds via AT Protocol API.
- user-invocable:
- false
- agent:
- python-general-engineer
- category:
- research
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 |
Related Skills
notque/shell-config
tools
VerifiedTrustedCommunity
Shell configuration: Fish and Zsh setup, PATH, completions, plugins.
412SKILL.mdUpdated Jul 6, 2026
notque/kubernetes
tools
VerifiedTrustedCommunity
Kubernetes operations: debugging, security, RBAC, and infrastructure tooling.
412SKILL.mdUpdated Jul 6, 2026
notque/swift
development
VerifiedTrustedCommunity
Swift development: concurrency patterns, async/await, actors, testing with XCTest and Swift Testing framework.
412SKILL.mdUpdated Jul 6, 2026
notque/php
development
VerifiedTrustedCommunity
PHP development: code quality, PSR standards, testing with PHPUnit.
412SKILL.mdUpdated Jul 6, 2026