Bluesky NZ
SkillSearchSearch public Bluesky posts and read public account feeds through the no-login Bluesky AppView API, tuned for New Zealand situational awareness: keyword and phrase search with recency sort, author feeds for official NZ accounts, and machine-readable post output. Use when the task involves scanning public social media for emerging NZ events, weather or hazard impacts, community reports, or monitoring a public Bluesky account. Read-only; no authentication required.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Bluesky NZ skill
What this skill tells your AI
The instructions your AI receives, as published by thecolab-ai/.skills in skills/bluesky-nz/SKILL.md and read by ahel’s review.
Goal
Search public Bluesky posts and read public account feeds through the keyless AppView API — a public social signal channel for detecting emerging NZ events (weather impacts, outages, community reports) and monitoring official accounts.
Use this when
- A task needs to scan public social media for emerging NZ incident reports
- A task needs recent public posts from a specific Bluesky account
- A workflow needs machine-readable public post data with engagement counts
Do not use this for
- Posting, liking, following, DMs, or anything requiring a session
- Private/protected content (only public posts are visible)
- Treating crowd posts as verified fact — corroborate against official sources
Commands
python3 skills/bluesky-nz/scripts/cli.py search "wellington south coast waves" --limit 20 --json
python3 skills/bluesky-nz/scripts/cli.py search "state of emergency" --since 2026-07-21 --lang en
python3 skills/bluesky-nz/scripts/cli.py feed metservice.com --limit 10
python3 skills/bluesky-nz/scripts/cli.py profile some-account.bsky.social
search QUERY [--sort latest|top] [--since ISO] [--lang CODE] [--limit N] [--json]— public post searchfeed HANDLE [--limit N] [--json]— recent public posts from one account (replies excluded)profile HANDLE [--json]— public profile summary
Notes
- Craft NZ-specific queries. Generic terms collide with overseas places — "wellington weather" surfaces Wellington, Ohio. Add NZ anchors: suburb names, "NZ", "Aotearoa", agency names.
- Verify handles before trusting an account. Handles are self-registered:
metservice.bsky.socialis a band, not the weather service. Runprofileand check the description/domain handle. A handle on the organisation's own domain, such asmetservice.com, is domain-verified. - Crowd posts are unverified by definition; the JSON output carries this warning.
- Timestamps are UTC as published. Post URLs link to the public web app.
Resources
- CLI entrypoint:
scripts/cli.py - Contract test:
scripts/test_contract.py; smoke test:scripts/smoke_test.py - Endpoint behaviour and rate-limit notes:
references/source-notes.md
Signals
- GitHub stars
- 25
- Forks
- 6
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
bluesky-nz- Source
- github.com/thecolab-ai/.skills