birdlisted

Drive the `bird` CLI for the X (Twitter) API — entity-store-backed reads (`--refresh` / `--no-cache` / `--cache-only`), watchlist monitoring, thread reconstruction, API usage and cost ledger, `bird doctor` self-diagnostics, JSON Schema output documents, search with sort/min-likes/pages, and the bird-specific write-op confirmation flow (`--dry-run`, `--force`, exit 2 `requires-confirmation`). Use when the user wants to read bookmarks or a profile, search recent tweets with ranking, rebuild a conversation thread, manage a watchlist, check API cost, inspect cache, run diagnostics, install the skill bundle, or any task where bird's local cache or structured error envelope matters. For OAuth flows, raw write-op transport, or full xr surface, route to the companion `xurl-rs` skill; for X API v2 endpoint, scope, and billing reference, route to the companion `x-api` skill. Triggers on "bird command", "bird search", "bird watchlist", "bird bookmarks", "bird thread", "bird doctor", "bird cache", "bird usage", "X API co
brettdavies/bird-skill · ★ 0 · API & Backend · score 68

Install: claude install-skill brettdavies/bird-skill

# bird `bird` is a Rust CLI that wraps the X (Twitter) v2 API with capabilities `xurl` does not have: a SQLite **entity store** with per-endpoint TTL, **watchlist** monitoring, **thread reconstruction**, **API usage** with local cost ledger, **structured error envelopes** with split exit codes (`0` / `1` / `2` / `77` / `78`), **JSON Schema** documents for every output shape, **search ergonomics** (`--sort likes --min-likes --pages`), and `bird doctor` self-diagnostics covering xurl status, auth state, command availability, and store health. bird does **not** implement HTTP or OAuth itself. Every API call shells out to `xr` (xurl-rs) or `xurl` (Go fallback) at runtime. Discovery order: `BIRD_XURL_PATH` env → `xr` on `$PATH` → `xurl` on `$PATH`. Minimum xurl version: 1.0.3. ## Sibling skills — install if you don't have them Two companion skills cover ground this skill deliberately does NOT duplicate. Reach for them when the task crosses their line. | Skill | Owns | Install | | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------