How do I install the Bird skill?

Run npx skillmds@latest add gabrielmoreira/bird in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bird?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

gabrielmoreira (@gabrielmoreira) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Bird by gabrielmoreira — Agent Skill

Name: Bird
Rating: 4.666666666666667 (3 reviews)
Author: gabrielmoreira

Bird

X/Twitter CLI for posting tweets, reading threads, searching, and fetching news. Use when user asks to tweet, reply, read tweets, search X/Twitter, get mentions, view bookmarks, likes, followers, following, user timelines, or fetch trending news/topics.

gabrielmoreira Updated Sep 21, 2026 17 repo stars

File contents

bird — X/Twitter CLI

This skill targets my @dannote/bird-premium package, which installs a bird binary. It is a fork of/derived from Peter Steinberger's original steipete/bird CLI, but uses the documented paid X API v2 instead of undocumented web GraphQL/cookie endpoints.

Package: @dannote/bird-premium
Original project credited: steipete/bird
Transport: official X API v2 with OAuth 1.0a and Bearer Token auth

Install

# one-shot (no install)
bunx @dannote/bird-premium whoami

# or install globally
npm install -g @dannote/bird-premium
# or: pnpm add -g @dannote/bird-premium
# or: bun add -g @dannote/bird-premium

Authentication

Env vars:

Bearer Token (app-only): X_BEARER_TOKEN
OAuth 1.0a (user context): X_API_KEY, X_API_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET

Bearer Token enables: search, read, user, user-tweets, followers, following OAuth 1.0a adds: tweet, reply, like, retweet, bookmark, follow, home, whoami, mentions

Commands

Post & Reply

bird tweet "Hello world"
bird tweet "Quote this" --quote <tweet-id>
bird reply <tweet-id-or-url> "Reply text"

Read

bird read <tweet-id-or-url>

Search

bird search "query" -n 20

Search covers the last 7 days.

Mentions

bird mentions -n 5
bird mentions <username> -n 5

Timelines

bird home -n 20
bird user-tweets <username> -n 20
bird user-tweets <username> --no-replies --no-retweets
bird list-timeline <list-id> -n 20

Bookmarks & Likes

bird bookmarks -n 10
bird likes -n 10
bird likes <username> -n 10
bird bookmark <tweet-id>
bird unbookmark <tweet-id>
bird like <tweet-id>
bird unlike <tweet-id>

Social Graph

bird followers <username> -n 20
bird following <username> -n 20
bird follow <username>
bird unfollow <username>

Retweets

bird retweet <tweet-id>
bird unretweet <tweet-id>

User Profile

bird user <username>

Account

bird whoami
bird check

Delete

bird delete <tweet-id>

Global Options

Flag	Description
`--json`	JSON output
`-n, --count <n>`	Number of results
`--cursor <token>`	Resume from cursor

JSON Output Schema

Tweet objects:

id, text, author ({username, name}), authorId
createdAt, conversationId, inReplyToStatusId
replyCount, retweetCount, likeCount
quotedTweet (nested)

User objects (following/followers):

id, username, name, description
followersCount, followingCount, isBlueVerified

---name: birddescription: X/Twitter CLI for posting tweets, reading threads, searching, and fetching news. Use when user asks to tweet, reply, read tweets, search X/Twitter, get mentions, view bookmarks, likes, followers, following, user timelines, or fetch trending news/topics.---# bird — X/Twitter CLIThis skill targets my `@dannote/bird-premium` package, which installs a `bird` binary. It is a fork of/derived from Peter Steinberger's original `steipete/bird` CLI, but uses the documented paid X API v2 instead of undocumented web GraphQL/cookie endpoints.- Package: `@dannote/bird-premium`- Original project credited: `steipete/bird`- Transport: official X API v2 with OAuth 1.0a and Bearer Token auth## Install```bash# one-shot (no install)bunx @dannote/bird-premium whoami# or install globallynpm install -g @dannote/bird-premium# or: pnpm add -g @dannote/bird-premium# or: bun add -g @dannote/bird-premium```## AuthenticationEnv vars:- **Bearer Token (app-only):** `X_BEARER_TOKEN`- **OAuth 1.0a (user context):** `X_API_KEY`, `X_API_SECRET`, `X_ACCESS_TOKEN`, `X_ACCESS_TOKEN_SECRET`Bearer Token enables: search, read, user, user-tweets, followers, followingOAuth 1.0a adds: tweet, reply, like, retweet, bookmark, follow, home, whoami, mentions## Commands### Post & Reply```bashbird tweet "Hello world"bird tweet "Quote this" --quote <tweet-id>bird reply <tweet-id-or-url> "Reply text"```### Read```bashbird read <tweet-id-or-url>```### Search```bashbird search "query" -n 20```Search covers the last 7 days.### Mentions```bashbird mentions -n 5bird mentions <username> -n 5```### Timelines```bashbird home -n 20bird user-tweets <username> -n 20bird user-tweets <username> --no-replies --no-retweetsbird list-timeline <list-id> -n 20```### Bookmarks & Likes```bashbird bookmarks -n 10bird likes -n 10bird likes <username> -n 10bird bookmark <tweet-id>bird unbookmark <tweet-id>bird like <tweet-id>bird unlike <tweet-id>```### Social Graph```bashbird followers <username> -n 20bird following <username> -n 20bird follow <username>bird unfollow <username>```### Retweets```bashbird retweet <tweet-id>bird unretweet <tweet-id>```### User Profile```bashbird user <username>```### Account```bashbird whoamibird check```### Delete```bashbird delete <tweet-id>```## Global Options| Flag | Description || ------------------ | ------------------ || `--json` | JSON output || `-n, --count <n>` | Number of results || `--cursor <token>` | Resume from cursor |## JSON Output SchemaTweet objects:- `id`, `text`, `author` (`{username, name}`), `authorId`- `createdAt`, `conversationId`, `inReplyToStatusId`- `replyCount`, `retweetCount`, `likeCount`- `quotedTweet` (nested)User objects (following/followers):- `id`, `username`, `name`, `description`- `followersCount`, `followingCount`, `isBlueVerified`

Frequently asked questions