{"id":50713872,"url":"https://github.com/zaydiscold/bird-skill","last_synced_at":"2026-06-09T17:04:20.939Z","repository":{"id":342381443,"uuid":"1173765526","full_name":"zaydiscold/bird-skill","owner":"zaydiscold","description":"claude code skill for bird — the twitter/x cli by @steipete. paste an x.com link in any agent and it reads it directly.","archived":false,"fork":false,"pushed_at":"2026-03-31T04:35:57.000Z","size":28,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-31T07:05:26.315Z","etag":null,"topics":["agent-skill","agentskills","bird","claude-code","cli","twitter","x"],"latest_commit_sha":null,"homepage":"https://zayd.wtf","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zaydiscold.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-05T18:17:07.000Z","updated_at":"2026-03-31T04:36:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zaydiscold/bird-skill","commit_stats":null,"previous_names":["zaydiscold/bird-skill"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zaydiscold/bird-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaydiscold%2Fbird-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaydiscold%2Fbird-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaydiscold%2Fbird-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaydiscold%2Fbird-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zaydiscold","download_url":"https://codeload.github.com/zaydiscold/bird-skill/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaydiscold%2Fbird-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34116466,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skill","agentskills","bird","claude-code","cli","twitter","x"],"created_at":"2026-06-09T17:04:20.261Z","updated_at":"2026-06-09T17:04:20.928Z","avatar_url":"https://github.com/zaydiscold.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/banner.svg\" alt=\"banner\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003ebird-skill\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003eclaude code skill for bird, the twitter/x cli. originally by \u003ca href=\"https://x.com/steipete\"\u003e@steipete\u003c/a\u003e.\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/skill-v1.1.1-B4A7D6?style=flat-square\u0026labelColor=1a1a2e\" alt=\"skill version\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/bird-v0.8.0-D4AF37?style=flat-square\u0026labelColor=1a1a2e\" alt=\"bird version\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/zayd.wtf-D4AF37?style=flat-square\u0026labelColor=1a1a2e\" alt=\"site\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#what-it-does\"\u003ewhat it does\u003c/a\u003e · \u003ca href=\"#install\"\u003einstall\u003c/a\u003e · \u003ca href=\"#usage\"\u003eusage\u003c/a\u003e · \u003ca href=\"#changelog\"\u003echangelog\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/stars1.svg\" alt=\"·\" /\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## what it does\n\n[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.\n\nthe original repo was removed from github. we keep it accessible at [zaydiscold/bird](https://github.com/zaydiscold/bird).\n\nthis 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.\n\nopen tools should stay open.\n\nworks in claude code, codex, cursor, openclaw, gemini. one install, all agents.\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/stars2.svg\" alt=\"·\" /\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## install\n\n**step 1:** install the bird cli\n\n```bash\n# from zaydiscold/bird — universal arm64/x86_64 binary\ncurl -L https://github.com/zaydiscold/bird/releases/download/v0.8.0/bird -o bird\nchmod +x bird\nsudo mv bird /usr/local/bin/bird\n```\n\n\u003e \u003csub\u003esteipete's original tap (`brew install steipete/tap/bird`) may no longer be maintained — use the curl install above.\u003c/sub\u003e\n\nverify it's working:\n\n```bash\nbird whoami  # should return your twitter handle\n```\n\nbird 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.\n\nfor full cli docs and archive: [zaydiscold/bird](https://github.com/zaydiscold/bird)\n\n**step 2:** install the skill\n\n```bash\nnpx skills add zaydiscold/bird-skill@bird -g -y  # global, all agents\n```\n\nor install to a single agent:\n\n```bash\nnpx skills add zaydiscold/bird-skill@bird -y  # current project only\n```\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/stars3.svg\" alt=\"·\" /\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## usage\n\nonce installed, the skill activates automatically. paste any x.com or twitter.com link and your agent reads it. no slash command needed.\n\n```bash\n# what the agent runs behind the scenes\nbird read https://x.com/user/status/123456789   # single tweet\nbird thread https://x.com/user/status/123456789  # full thread\nbird search \"query\" -n 20                         # search tweets\nbird mentions -n 20                               # your mentions\nbird home -n 20                                   # for you feed\nbird home --following -n 20                       # chronological\nbird news --ai-only                               # trending topics\nbird user-tweets @handle -n 20                    # someone's profile\n```\n\nposting requires a confirm from you first. reading is automatic.\n\n```bash\nbird tweet \"text here\"              # post a tweet\nbird reply \u003curl-or-id\u003e \"reply\"      # reply to a tweet\nbird follow @handle\nbird bookmarks -n 20\nbird likes -n 20\n```\n\noutput options:\n\n```bash\nbird read \u003cid\u003e --json        # structured json\nbird search \"q\" --plain      # no color, pipeable\n```\n\n\u003csub\u003eall 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\u003c/sub\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/stars4.svg\" alt=\"·\" /\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## compatibility \u0026 limitations\n\n- Works on macOS with a browser profile (Safari or Chrome) that has an authenticated bird session.\n- 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.\n- Requires `bird` v0.8.0+ and a functioning cookie-backed auth state.\n- The skill currently gates write actions behind explicit confirmation (`tweet`, `reply`, `follow`, `unfollow`, `unbookmark`).\n- Inputs are validated before execution; only x.com / twitter.com content links, status IDs, and explicit action commands are supported.\n- List-style outputs default to `N=12` for compact responses, then offer `show more` for additional chunks.\n- This skill intentionally uses only `Bash` tooling and avoids browser automation/WebFetch for reads and writes.\n\n## release verification checklist\n\nBefore publishing a new skill version, verify:\n\n- `metadata.version` in `bird/SKILL.md` and the README skill badge both match the release tag.\n- `SKILL_TESTS.md` core scenarios pass (trigger, functional, and failure-mode checks).\n- `SKILL.md` preflight/auth flow works for: missing binary, unauthorized, and private/protected responses.\n- `README.md` has matching changelog entry, installation steps, and compatibility notes.\n- `npx skills publish` checks (or equivalent distribution check) include this directory with updated files.\n\nVerification command examples:\n\n```bash\n# quick local consistency checks\ngrep -n \"metadata:\\n  version\" bird/SKILL.md\ngrep -n \"skill-v1.1.0\" README.md\npython -m markdown\n# run your normal smoke tests using SKILL_TESTS.md\n```\n\n\n## changelog\n\n### v1.1.1\n- made Safari the explicit first/default auth path in the skill docs\n- added agent-shell recovery guidance for Safari cookie permission failures\n- documented Chrome profile probing and `~/.config/bird/config.json5` fallback persistence\n- synced README version badge with skill metadata\n\n### v1.1.0\n- added explicit preflight command sequencing and auth gating\n- added explicit write-command confirmation protocol for side-effect actions\n- added URL normalization and malformed input rejection\n- added default N=12 list output cap with show-more policy\n- expanded troubleshooting cases (private/protected, suspended/deleted, malformed input, network/DNS, timeout)\n- moved detailed operators/write/error guidance into `references/` docs and added `SKILL_TESTS.md` test matrix\n- added compatibility + release verification checklist and version-sync rule\n\n### v1.0.4\n- smarter install detection (`command -v` + `~/.local/bin` fallback instead of `which`)\n- search operators quick reference (from:, to:, filter:, date ranges, engagement filters)\n- output presentation rules — agent knows when to show raw vs summarize vs curate\n- batch URL handling — multiple tweet links processed sequentially\n- cleaned up stale HTML comment in readme\n\n### v1.0.3\n- aligned skill with [anthropic's official skill guide](https://resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf)\n- added `license`, `compatibility`, and standard `metadata` fields to frontmatter\n- added negative trigger in description to prevent over-triggering on content strategy tasks\n- added overview line at top of skill body\n- added concrete examples section (URL read, search, post) per guide's recommended template\n- renamed error handling → troubleshooting with structured error/cause/solution format\n\n### v1.0.2\n- skill now detects missing bird binary on invocation and offers to install from [zaydiscold/bird](https://github.com/zaydiscold/bird/releases)\n- install section updated with curl fallback for when steipete's brew tap is unavailable\n\n### v1.0.1\n- updated description: x.com/twitter.com URL trigger is now first (stronger auto-invoke)\n- added `bird v0.8.0` badge\n- credits @steipete as original bird author\n- auth line now shows `@ColdCooks` for clarity\n- bash-only design note (no browser, no webfetch — that's the point)\n- links to [zaydiscold/bird](https://github.com/zaydiscold/bird) for cli docs and archive\n\n### v1.0.0\n- initial release: read, search, thread, post, timeline\n- cross-agent: claude code, codex, cursor, openclaw, gemini\n- follows agentskills open standard\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://star-history.com/#zaydiscold/bird-skill\u0026Date\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=zaydiscold/bird-skill\u0026type=Date\u0026theme=dark\" /\u003e\n      \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=zaydiscold/bird-skill\u0026type=Date\" /\u003e\n      \u003cimg src=\"https://api.star-history.com/svg?repos=zaydiscold/bird-skill\u0026type=Date\u0026theme=dark\" width=\"320\" alt=\"star history chart\" /\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003emit. \u003ca href=\"./LICENSE\"\u003elicense\u003c/a\u003e\u003c/p\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/stars5.svg\" alt=\"·\" /\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003cp align=\"left\"\u003e\u003cstrong\u003ezayd / cold\u003c/strong\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://zayd.wtf\"\u003ezayd.wtf\u003c/a\u003e · \u003ca href=\"https://x.com/coldcooks\"\u003etwitter\u003c/a\u003e · \u003ca href=\"https://github.com/zaydiscold\"\u003egithub\u003c/a\u003e\n  \u003cbr\u003e\n  \u003cem\u003eicarus only fell because he flew\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"right\"\u003e\n  \u003cstrong\u003eto do\u003c/strong\u003e\u003cbr\u003e\n  \u003csub\u003e\n  ☑ core skill: read, search, thread, post, timeline\u003cbr\u003e\n  ☑ cross-agent: claude code, codex, cursor, openclaw, gemini\u003cbr\u003e\n  ☑ follows agentskills open standard\u003cbr\u003e\n  ☑ auto-install bird if missing\u003cbr\u003e\n  ☑ aligned with anthropic's official skill guide\u003cbr\u003e\n  ☐ skills.sh listing\u003cbr\u003e\n  ☐ firefox profile support in skill\u003cbr\u003e\n  ☐ multi-account switching\n  \u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/wisps.svg\" alt=\"\" /\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzaydiscold%2Fbird-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzaydiscold%2Fbird-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzaydiscold%2Fbird-skill/lists"}