bluesky-nz

Files (7)

• SKILL.md
• source-notes.md · references/
• cli.py · scripts/
• smoke_test.py · scripts/
• test_contract.py · scripts/
• contract.json · tests/fixtures/
• searchposts-sample.json · tests/fixtures/

SKILL.md (first lines)

# Bluesky NZ

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

```bash
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 search
- `feed 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.social` is a band, not the weather service. Run `profile`
  and check the description/domain handle. A handle on the organisation's own
  domain, such as `metservice.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`

From thecolab-ai/.skills, MIT.

More from thecolab-ai/.skills