Skip to content

docs(skill_en): replace stale bird CLI with twitter#287

Open
yagyesh-twofourlabs wants to merge 1 commit intoPanniantong:mainfrom
yagyesh-twofourlabs:fix/skill-en-bird-rename
Open

docs(skill_en): replace stale bird CLI with twitter#287
yagyesh-twofourlabs wants to merge 1 commit intoPanniantong:mainfrom
yagyesh-twofourlabs:fix/skill-en-bird-rename

Conversation

@yagyesh-twofourlabs
Copy link
Copy Markdown

Summary

  • The English SKILL.md (agent_reach/skill/SKILL_en.md) still documented a bird CLI for Twitter/X reads. That binary isn't shipped/installed by agent-reach anymore — agents calling bird read <url> hit command not found and fall back to slower paths (Jina Reader, browser automation).
  • The Chinese SKILL.md was already migrated to twitter (twitter-cli). This PR brings the English doc in line.

Changes

  • bird searchtwitter -c search
  • bird readtwitter -c tweet
  • bird user-tweetstwitter -c user-posts
  • Added twitter -c article and twitter -c feed examples
  • Added a hint to run pipx upgrade twitter-cli if search returns 404 (matches existing guidance in references/social.md)

Docs-only; no code changes.

Test plan

  • Confirmed twitter -c tweet <x.com/status URL> returns the tweet + replies as JSON on a fresh install (twitter-cli 0.8.5, env from ~/.agent-reach/env.sh).
  • Existing references/social.md already uses these exact subcommand names — this aligns the top-level English skill with the reference doc.

🤖 Generated with Claude Code

The English SKILL.md still documented a `bird` binary that no longer
exists on user systems — invocations like `bird read <url>` fail with
`command not found`. The Chinese SKILL.md was already updated to use
`twitter` (twitter-cli, the actual installed binary via pipx).

This brings the English version in line:

- `bird search` → `twitter -c search`
- `bird read`   → `twitter -c tweet`
- `bird user-tweets` → `twitter -c user-posts`
- adds `article` and `feed` examples
- adds a note pointing users to `pipx upgrade twitter-cli` if search 404s

No code changes — docs only.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants