twitter-reader
Read Twitter/X for financial research through opencli: the user's home timeline, tweet search, trending topics, bookmarks, a user's recent tweets, threads, articles, profiles, followers and following, and notifications.
Install / Use
npx skills add himself65/finance-skills --skill twitter-readerInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
CommunicationSupported Platforms
Tags
Our assessment of twitter-reader
twitter-reader scores 94/100 on our quality scale, 100th of 394 Communication skills we index (top 26%).
Its SKILL.md is 7.3 KB long, well organised into 19 sections with 5 code examples: a thorough specification that gives an agent plenty to work with.
With 3,348 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 3 months ago, so twitter-reader is actively maintained.
- Our last check on 2026-11-16 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-02. Automated pattern scan on 2026-10-02. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
twitter-reader compared with similar skills
All 4 of these similar skills score higher than twitter-reader; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| twitter-reader (this skill)by himself65 | 94 | 3.3k | 3mo ago | SKILL.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 149.0k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install twitter-reader?
- Run
npx skills add himself65/finance-skills --skill twitter-reader. The install tabs above show the steps for each supported agent. - Which AI agents does twitter-reader work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is twitter-reader safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is twitter-reader still maintained?
- The repository was last updated about 3 months ago, so twitter-reader is actively maintained.
Skill content
View source on GitHubname: twitter-reader description: > Read Twitter/X for financial research through opencli: the user's home timeline, tweet search, trending topics, bookmarks, a user's recent tweets, threads, articles, profiles, followers and following, and notifications. Use this skill whenever the user wants to know what people are saying on Twitter/X or fintwit about a stock, topic, or market event, check their feed or bookmarks, see what's trending, or look up an @account and its posts. Read-only: it cannot post, like, retweet, reply, or follow.
Twitter Skill (Read-Only)
Reads Twitter/X for financial research using opencli, a universal CLI tool that bridges web services to the terminal via browser session reuse.
This skill is read-only. It is designed for financial research: searching market discussions, reading analyst tweets, tracking sentiment, and monitoring financial news on Twitter/X. It does NOT support posting, liking, retweeting, replying, or any write operations.
Important: opencli reuses your existing Chrome login session — no API keys or cookie extraction needed. Just be logged into x.com in Chrome and have the Browser Bridge extension installed.
Step 1: Ensure opencli Is Installed and Ready
Current environment status:
!`(command -v opencli && opencli doctor 2>&1 | head -5 && echo "READY" || echo "SETUP_NEEDED") 2>/dev/null || echo "NOT_INSTALLED"`
If the status above shows READY, skip to Step 2. If NOT_INSTALLED, install first:
# Install opencli globally
npm install -g @jackwener/opencli
If SETUP_NEEDED, guide the user through setup:
Setup
opencli requires Node.js >= 20 and a Chrome browser with the Browser Bridge extension:
- Install the Browser Bridge extension:
- Download the latest
opencli-extension-v{version}.zipfrom the GitHub Releases page - Unzip it, open
chrome://extensionsin Chrome, and enable Developer mode - Click Load unpacked and select the unzipped folder
- Download the latest
- Login to x.com in Chrome — opencli reuses your existing browser session
- Verify connectivity:
opencli doctor
This auto-starts the daemon, verifies the extension is connected, and checks session health.
Common setup issues
| Symptom | Fix |
|---------|-----|
| Extension not connected | Install Browser Bridge extension in Chrome and ensure it's enabled |
| Daemon not running | Run opencli doctor — it auto-starts the daemon |
| No session for twitter.com | Login to x.com in Chrome, then retry |
| CSRF token missing | Refresh x.com in Chrome to regenerate the ct0 cookie |
Step 2: Identify What the User Needs
Match the user's request to one of the read commands below, then use the corresponding command from references/commands.md.
| User Request | Command | Key Flags |
|---|---|---|
| Setup check | opencli doctor | — |
| Home feed / timeline | opencli twitter timeline | --type for-you\|following, --limit N (default 20) |
| Search tweets | opencli twitter search "QUERY" | --filter top\|live, --limit N (default 15) |
| Trending topics | opencli twitter trending | --limit N (default 20) |
| Bookmarks | opencli twitter bookmarks | --limit N (default 20) |
| Recent tweets from a user | opencli twitter tweets USERNAME | --limit N (default 20) |
| View a specific thread | opencli twitter thread TWEET_ID | --limit N (default 50) |
| Twitter article | opencli twitter article TWEET_ID | — |
| User profile | opencli twitter profile USERNAME | — (defaults to logged-in user) |
| Followers | opencli twitter followers USERNAME | --limit N (default 50) |
| Following | opencli twitter following USERNAME | --limit N (default 50) |
| Notifications | opencli twitter notifications | --limit N (default 20) |
Step 3: Execute the Command
General pattern
# Use -f json or -f yaml for structured output
opencli twitter timeline -f json --limit 20
opencli twitter timeline --type following --limit 20
# Recent tweets from a specific user
opencli twitter tweets elonmusk --limit 20 -f json
# Searching for financial topics
opencli twitter search "$AAPL earnings" --filter live --limit 10 -f json
opencli twitter search "Fed rate decision" --limit 20 -f yaml
# Trending topics
opencli twitter trending --limit 20 -f json
Key rules
- Check setup first — run
opencli doctorbefore any other command if unsure about connectivity - Use
-f jsonor-f yamlfor structured output when processing data programmatically - Use
-f csvwhen the user wants spreadsheet-compatible output - Use
--limit Nto control result count — start with 10-20 unless the user asks for more - For search, use
--filter—top(default) for relevance,livefor latest tweets - Read-only — don't post, like, retweet, reply, quote, follow, or delete, even though opencli exposes some of these commands
Output format flag (-f)
| Format | Flag | Best for |
|---|---|---|
| Table | -f table (default) | Human-readable terminal output |
| JSON | -f json | Programmatic processing, LLM context |
| YAML | -f yaml | Structured output, readable |
| Markdown | -f md | Documentation, reports |
| CSV | -f csv | Spreadsheet export |
Output columns
Tweet-listing commands (timeline, search, thread) include: id, author, text, created_at, likes, retweets, replies, views, url, has_media, media_urls.
tweets (per-user posts) also includes is_retweet.
bookmarks columns: author, text, likes, retweets, bookmarks, url.
trending columns: rank, topic, tweets, category.
Profile (profile) columns: screen_name, name, bio, location, url, followers, following, tweets, likes, verified, created_at.
followers / following columns: screen_name, name, bio, followers.
notifications columns: id, action, author, text, url.
Step 4: Present the Results
Lead with what matters for the user's research question rather than a raw dump. Attribute each tweet (@handle, text, engagement such as likes and views, and the URL when the user may want the full thread), group search results by theme, and note the bullish or bearish lean and where views are consensus or contrarian. For profiles, give follower count, bio, and notable recent activity. Keep browser session details private.
Step 5: Diagnostics
If something isn't working, run:
opencli doctor
This checks daemon status, extension connectivity, and browser session health.
Error Reference
| Error | Cause | Fix |
|-------|-------|-----|
| Extension not connected | Browser Bridge not installed/enabled | Install extension and enable it in Chrome |
| No session | Not logged into x.com | Login to x.com in Chrome |
| CSRF token missing | Cookie expired or page needs refresh | Refresh x.com in Chrome |
| Rate limited | Too many requests | Wait a few minutes, then retry |
Reference Files
references/commands.md— Complete read command reference with all flags, research workflows, and usage examplesreferences/schema.md— Output format documentation and column definitions
Read the reference files when you need exact command syntax, research workflow patterns, or output details.
Related Skills
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
149.0kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
