https://github.com/zaydiscold/bird-skill
claude code skill for bird — the twitter/x cli by @steipete. paste an x.com link in any agent and it reads it directly.
https://github.com/zaydiscold/bird-skill
agent-skill agentskills bird claude-code cli twitter x
Last synced: 9 days ago
JSON representation
claude code skill for bird — the twitter/x cli by @steipete. paste an x.com link in any agent and it reads it directly.
- Host: GitHub
- URL: https://github.com/zaydiscold/bird-skill
- Owner: zaydiscold
- License: mit
- Created: 2026-03-05T18:17:07.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2026-03-31T04:35:57.000Z (3 months ago)
- Last Synced: 2026-03-31T07:05:26.315Z (3 months ago)
- Topics: agent-skill, agentskills, bird, claude-code, cli, twitter, x
- Homepage: https://zayd.wtf
- Size: 27.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
bird-skill
claude code skill for bird, the twitter/x cli. originally by @steipete.
what it does · install · usage · changelog
## what it does
[bird](https://github.com/steipete/bird) is a fast cli for twitter/x, built by [@steipete](https://x.com/steipete). reads tweets, searches, posts, follows, checks your timeline. all from the terminal using your browser's saved cookies — no api keys, no oauth dance.
the original repo was removed from github. we keep it accessible at [zaydiscold/bird](https://github.com/zaydiscold/bird).
this is a claude code skill that wraps it. paste an x.com link into any conversation and your agent reads it directly. no browser tab, no webfetch, no auth setup. the skill is bash-only by design (`allowed-tools: Bash`) — that's the whole point: agents read twitter without opening a browser.
open tools should stay open.
works in claude code, codex, cursor, openclaw, gemini. one install, all agents.
## install
**step 1:** install the bird cli
```bash
# from zaydiscold/bird — universal arm64/x86_64 binary
curl -L https://github.com/zaydiscold/bird/releases/download/v0.8.0/bird -o bird
chmod +x bird
sudo mv bird /usr/local/bin/bird
```
> steipete's original tap (`brew install steipete/tap/bird`) may no longer be maintained — use the curl install above.
verify it's working:
```bash
bird whoami # should return your twitter handle
```
bird uses safari or chrome cookies automatically. safari should stay the default path. if safari works in your normal terminal but fails inside an agent shell, the skill now tells the agent to probe chrome profiles and persist a fallback config instead of incorrectly telling you to relogin.
for full cli docs and archive: [zaydiscold/bird](https://github.com/zaydiscold/bird)
**step 2:** install the skill
```bash
npx skills add zaydiscold/bird-skill@bird -g -y # global, all agents
```
or install to a single agent:
```bash
npx skills add zaydiscold/bird-skill@bird -y # current project only
```
## usage
once installed, the skill activates automatically. paste any x.com or twitter.com link and your agent reads it. no slash command needed.
```bash
# what the agent runs behind the scenes
bird read https://x.com/user/status/123456789 # single tweet
bird thread https://x.com/user/status/123456789 # full thread
bird search "query" -n 20 # search tweets
bird mentions -n 20 # your mentions
bird home -n 20 # for you feed
bird home --following -n 20 # chronological
bird news --ai-only # trending topics
bird user-tweets @handle -n 20 # someone's profile
```
posting requires a confirm from you first. reading is automatic.
```bash
bird tweet "text here" # post a tweet
bird reply "reply" # reply to a tweet
bird follow @handle
bird bookmarks -n 20
bird likes -n 20
```
output options:
```bash
bird read --json # structured json
bird search "q" --plain # no color, pipeable
```
all bird commands: read, thread, replies, search, mentions, home, bookmarks, likes, user-tweets, news, lists, list-timeline, following, followers, about, tweet, reply, follow, unfollow, unbookmark, whoami, check
## compatibility & limitations
- Works on macOS with a browser profile (Safari or Chrome) that has an authenticated bird session.
- Prefers Safari when available. If Safari cookie access fails only inside an agent shell, the skill now treats Chrome as a fallback recovery path rather than as the primary source.
- Requires `bird` v0.8.0+ and a functioning cookie-backed auth state.
- The skill currently gates write actions behind explicit confirmation (`tweet`, `reply`, `follow`, `unfollow`, `unbookmark`).
- Inputs are validated before execution; only x.com / twitter.com content links, status IDs, and explicit action commands are supported.
- List-style outputs default to `N=12` for compact responses, then offer `show more` for additional chunks.
- This skill intentionally uses only `Bash` tooling and avoids browser automation/WebFetch for reads and writes.
## release verification checklist
Before publishing a new skill version, verify:
- `metadata.version` in `bird/SKILL.md` and the README skill badge both match the release tag.
- `SKILL_TESTS.md` core scenarios pass (trigger, functional, and failure-mode checks).
- `SKILL.md` preflight/auth flow works for: missing binary, unauthorized, and private/protected responses.
- `README.md` has matching changelog entry, installation steps, and compatibility notes.
- `npx skills publish` checks (or equivalent distribution check) include this directory with updated files.
Verification command examples:
```bash
# quick local consistency checks
grep -n "metadata:\n version" bird/SKILL.md
grep -n "skill-v1.1.0" README.md
python -m markdown
# run your normal smoke tests using SKILL_TESTS.md
```
## changelog
### v1.1.1
- made Safari the explicit first/default auth path in the skill docs
- added agent-shell recovery guidance for Safari cookie permission failures
- documented Chrome profile probing and `~/.config/bird/config.json5` fallback persistence
- synced README version badge with skill metadata
### v1.1.0
- added explicit preflight command sequencing and auth gating
- added explicit write-command confirmation protocol for side-effect actions
- added URL normalization and malformed input rejection
- added default N=12 list output cap with show-more policy
- expanded troubleshooting cases (private/protected, suspended/deleted, malformed input, network/DNS, timeout)
- moved detailed operators/write/error guidance into `references/` docs and added `SKILL_TESTS.md` test matrix
- added compatibility + release verification checklist and version-sync rule
### v1.0.4
- smarter install detection (`command -v` + `~/.local/bin` fallback instead of `which`)
- search operators quick reference (from:, to:, filter:, date ranges, engagement filters)
- output presentation rules — agent knows when to show raw vs summarize vs curate
- batch URL handling — multiple tweet links processed sequentially
- cleaned up stale HTML comment in readme
### v1.0.3
- aligned skill with [anthropic's official skill guide](https://resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf)
- added `license`, `compatibility`, and standard `metadata` fields to frontmatter
- added negative trigger in description to prevent over-triggering on content strategy tasks
- added overview line at top of skill body
- added concrete examples section (URL read, search, post) per guide's recommended template
- renamed error handling → troubleshooting with structured error/cause/solution format
### v1.0.2
- skill now detects missing bird binary on invocation and offers to install from [zaydiscold/bird](https://github.com/zaydiscold/bird/releases)
- install section updated with curl fallback for when steipete's brew tap is unavailable
### v1.0.1
- updated description: x.com/twitter.com URL trigger is now first (stronger auto-invoke)
- added `bird v0.8.0` badge
- credits @steipete as original bird author
- auth line now shows `@ColdCooks` for clarity
- bash-only design note (no browser, no webfetch — that's the point)
- links to [zaydiscold/bird](https://github.com/zaydiscold/bird) for cli docs and archive
### v1.0.0
- initial release: read, search, thread, post, timeline
- cross-agent: claude code, codex, cursor, openclaw, gemini
- follows agentskills open standard
mit. license
zayd / cold
zayd.wtf · twitter · github
icarus only fell because he flew
to do
☑ core skill: read, search, thread, post, timeline
☑ cross-agent: claude code, codex, cursor, openclaw, gemini
☑ follows agentskills open standard
☑ auto-install bird if missing
☑ aligned with anthropic's official skill guide
☐ skills.sh listing
☐ firefox profile support in skill
☐ multi-account switching
