skills.rest
sota411
sota411COMMUNITY
Explore all skills by this author →
GitHub

bird

Search X/Twitter posts with the read-only bird CLI for social context in web research.

1|Updated Jul 16, 2026
Search Tags:#social media#cli#web research#twitter#sentiment#bird#x search
One-click install
npx skills add https://github.com/sota411/codex-config --skill bird-sota411
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bird
Source: https://github.com/sota411/codex-config/tree/main/user-skills/bird
Command: npx skills add https://github.com/sota411/codex-config --skill bird-sota411

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @steipete/bird.

What problem does it solve? Web search alone often misses real-time social signals like breaking news reactions, outage reports, and community sentiment. This Skill adds read-only X/Twitter search to research workflows so answers can include current public posts alongside traditional web sources. ## Core Features & Use Cases - Read-only X/Twitter search: Run bird search with query operators like from: and lang: to find relevant posts, threads, and user timelines. - Credential preflight check: bird check verifies authentication via browser cookies or AUTH_TOKEN/CT0 environment variables before any query runs. - Safe research guardrails: Only read commands are allowed; posting, liking, following, and private timeline commands are explicitly forbidden. - Use Case: When investigating whether a cloud service is down, combine standard web sources with bird search "aws outage" -n 5 --json --plain to surface real-time user reports, citing tweet URLs and timestamps separately from verified sources. ## Quick Start Use the bird skill to search X for recent reactions to the latest OpenAI announcement and summarize the sentiment alongside web sources.

Frequently Asked Questions about bird

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search X/Twitter from the command line?▼

Use the bird CLI with `bird search "<query>" -n 5 --json --plain` to run read-only searches. It supports X search operators like `from:openai` and `lang:ja` for focused queries, and paginates with `--all --max-pages` options.

What authentication does the bird CLI need for X search?▼

bird requires either an active browser login to x.com with readable cookies, or the AUTH_TOKEN and CT0 environment variables, or explicit --auth-token and --ct0 flags. Run `bird check` first to verify credentials before querying.

Can bird post tweets or follow accounts?▼

This skill forbids all write commands including tweet, reply, follow, unfollow, bookmarks, and likes. Only read-only commands such as search, read, thread, replies, user-tweets, news, and trending are permitted.

Why does bird search return a 404 error?▼

A 404 from X internals usually means stale GraphQL query IDs. Run `bird query-ids --fresh` to refresh them, then retry the command once before investigating further.

How should X/Twitter results be combined with web search?▼

Present web sources and X posts separately, treating posts as social signals rather than verified facts. Cite tweet URLs, authors, and timestamps, and prefer primary web sources when the two conflict.

Related Skills

Explore More Content & Communication Skills→
hamelsmuhamelsmu

twitter

Export liked and bookmarked tweets from Twitter/X to JSON files.

Community
Intermediate
bogwarebogware
3

web-research

Decompose research questions into subtopics and synthesize cited web findings.

Official
Advanced
EliasOulkadiEliasOulkadi
110

research

Verify factual claims via web search with evidence hierarchy and source credibility checks.

Community
Advanced
kaminocorpkaminocorp
1

xitter

Interact with X/Twitter via the x-cli terminal client using official API credentials.

Official
Intermediate