Social Content
freekmurze/dotfiles
When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms.
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…
Install Twitter Reader
$ npx skills add himself65/finance-skills --skill twitter-reader -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install himself65/finance-skills twitter-reader --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/himself65/finance-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/social-readers/skills/twitter-reader .claude/skills/twitter-reader && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "twitter-reader" agent skill from https://github.com/himself65/finance-skills/tree/main/plugins/social-readers/skills/twitter-reader into .claude/skills/twitter-reader/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "twitter-reader", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/himself65/finance-skills/tree/main/plugins/social-readers/skills/twitter-readerType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add himself65/finance-skills --skill twitter-reader -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install himself65/finance-skills twitter-reader --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/himself65/finance-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/social-readers/skills/twitter-reader .agents/skills/twitter-reader && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "twitter-reader" agent skill from https://github.com/himself65/finance-skills/tree/main/plugins/social-readers/skills/twitter-reader into .agents/skills/twitter-reader/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "twitter-reader", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add himself65/finance-skills --skill twitter-reader -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install himself65/finance-skills twitter-reader --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/himself65/finance-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/social-readers/skills/twitter-reader .cursor/skills/twitter-reader && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "twitter-reader" agent skill from https://github.com/himself65/finance-skills/tree/main/plugins/social-readers/skills/twitter-reader into .cursor/skills/twitter-reader/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "twitter-reader", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/himself65/finance-skills.git --path plugins/social-readers/skills/twitter-reader--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add himself65/finance-skills --skill twitter-reader -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install himself65/finance-skills twitter-reader --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/himself65/finance-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/social-readers/skills/twitter-reader .gemini/skills/twitter-reader && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "twitter-reader" agent skill from https://github.com/himself65/finance-skills/tree/main/plugins/social-readers/skills/twitter-reader into .gemini/skills/twitter-reader/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "twitter-reader", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install himself65/finance-skills twitter-readerInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add himself65/finance-skills --skill twitter-reader -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/himself65/finance-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/social-readers/skills/twitter-reader .github/skills/twitter-reader && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "twitter-reader" agent skill from https://github.com/himself65/finance-skills/tree/main/plugins/social-readers/skills/twitter-reader into .github/skills/twitter-reader/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "twitter-reader", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add himself65/finance-skills --skill twitter-reader -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install himself65/finance-skills twitter-reader --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/himself65/finance-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/social-readers/skills/twitter-reader .opencode/skills/twitter-reader && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "twitter-reader" agent skill from https://github.com/himself65/finance-skills/tree/main/plugins/social-readers/skills/twitter-reader into .opencode/skills/twitter-reader/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "twitter-reader", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
twitter-reader- GitHub stars
- 3.4k
- Token cost
- ~1.9k tokens
- SKILL.md length
- 777 words
- Files
- 4 (incl. references)
- Skills in repo
- 22
- Repo updated
- First seen
- Licence
- MIT
At a glance
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…
- Works in 5 steps: Ensure opencli Is Installed and Ready → Identify What the User Needs → Execute the Command → …
- The user wants to know what people are saying on Twitter/X
- SKILL.md covers Step 1: Ensure opencli Is…, Step 2: Identify What the User…, Step 3: Execute the Command and Step 4: Present the Results, plus 3 more sections
- Calls npm
What it does
Twitter Reader is an agent skill from himself65/finance-skills. 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.
Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `README.md`, `references/commands.md` and `references/schema.md`).
It sits in Writing & Content, covering Social media posts. It works with X (Twitter). The repository describes itself as: A collection of skills for AI financial analysis. The licence is MIT.
When your agent uses it
- The user wants to know what people are saying on Twitter/X
- Fintwit about a stock
- Check their feed
- See whats trending
Example prompts
- “s home timeline, tweet search, trending topics, bookmarks, a user”
- “/twitter-reader”
Requirements
- Node.js
Workflow steps
5 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 01fc7b4. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
npm
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
github.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Twitter Reader loads about 1.9k tokens when it runs, and up to ~5.1k if it reads all its reference files. Until then it costs about 129 tokens; SKILL.md has 777 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from himself65/finance-skills at commit 01fc7b4, republished under its MIT licence (© himself65). 777 words, ~1,867 tokens.
Download SKILL.mdSave it as
.claude/skills/twitter-reader/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.- name
- 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/opencliIf 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 doctorThis 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 jsonKey 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
Show full SKILL.md (290 more words)Show less
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 doctorThis 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.
© himself65, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 3 other files (references) in plugins/social-readers/skills/twitter-reader of himself65/finance-skills.
- SKILL.md
- README.md
- references/commands.md
- references/schema.md
Open the folder on GitHubat commit 01fc7b4
Compare with similar skills
Twitter Reader next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Twitter Reader this skillhimself65/finance-skills | 3.4k | — | ~1.9k | Automated safety check: Pass | MIT | |
| Social Contentfreekmurze/dotfiles | 1k | 22 repos | ~2.1k | Automated safety check: Pass | None | |
| Typefullyfreekmurze/dotfiles | 1k | 1 repos | ~3.4k | Automated safety check: Notes | None | |
| Changelog Social RecapFlorianBruniaux/claude-code-ultimate-guide | 6.1k | — | ~1.8k | Automated safety check: Notes | CC-BY-SA-4.0 | |
| X Mastery Mentoralchaincyf/x-mentor-skill | 1.2k | — | ~2.3k | Automated safety check: Pass | MIT | |
| Voice Buildercharlie947/social-media-skills | 3.8k | — | ~3.3k | Automated safety check: Pass | MIT |
Similar skills
Typefully
freekmurze/dotfiles
Create, schedule, and manage social media posts via Typefully.
Changelog Social Recap
FlorianBruniaux/claude-code-ultimate-guide
Turns CHANGELOG.md entries for a release or a week into LinkedIn, Twitter/X, newsletter and Slack posts in French and English.
X Mastery Mentor
alchaincyf/x-mentor-skill
$10K/hr级X/Twitter运营导师。基于Nicolas Cole、Dickie Bush、Sahil Bloom、Justin Welsh、 Dan Koe、Alex Hormozi六位顶级创作者的方法论 + X开源算法深度分析 + AI/科技赛道专精策略， 提炼6个核心心智模型、10条决策启发式、完整的选题-写作-增长操作手册。
Voice Builder
charlie947/social-media-skills
Build a personalised voice profile inside a Codex or Claude project from a short interview plus 3 to 5 sample pieces of writing.
Social Post
Hao0321/claude-skill-social-post
依使用者真實貼文與成效寫 Facebook／Instagram／YouTube／Threads／X 文案，包含 ChatGPT Chat 的「寫文」「Mode C」「用我的格式／口氣」「黑底白字」；本機工作台、規劃、確認後發布、留言回覆及成效學習。使用者說「發文」「文案」「Social Post 介面」「回覆留言」「查流量」「把數據訓練進去」「比較貼文」「優化 pattern」時使用。
More from himself65/finance-skills
All 22 skills in this repoCompany Valuation
himself65/finance-skills
Estimate a public company's intrinsic value with DCF, relative (peer multiple), and sum-of-the-parts (SOTP) methods, then blend them into an implied share price with upside/downside vs the market…
Discord Reader
himself65/finance-skills
Read Discord for financial research through opencli connected to the Discord desktop app: servers, channels, members, recent messages in the active channel, and message search.
Earnings Preview
himself65/finance-skills
Build a pre-earnings briefing for a stock from Yahoo Finance data (yfinance): the upcoming report date and timing, consensus EPS and revenue estimates with their range, the beat/miss track record…
Earnings Recap
himself65/finance-skills
Analyze a company's most recent (or a specified past) earnings report from Yahoo Finance data (yfinance): actual vs estimated EPS, surprise size, revenue and margin trends, and the stock's price…
Estimate Analysis
himself65/finance-skills
Analyze sell-side analyst estimates and how they are changing, using Yahoo Finance data (yfinance): EPS and revenue consensus by period, estimate ranges and dispersion, revision trends over…
Fintel Data
himself65/finance-skills
Query Fintel (fintel.io) institutional market data through its REST API or official MCP server.
Related
Works with
Categories
Questions about Twitter Reader
What does Twitter Reader do?
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…. Twitter Reader is an agent skill from himself65/finance-skills. 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.
When should I use Twitter Reader?
Twitter Reader fits situations like: the user wants to know what people are saying on Twitter/X; fintwit about a stock; check their feed; see whats trending.
How do I install Twitter Reader in Claude Code?
Run `npx skills add himself65/finance-skills --skill twitter-reader -a claude-code`. Or copy the skill folder (plugins/social-readers/skills/twitter-reader in himself65/finance-skills) into .claude/skills/twitter-reader in your project. Claude Code loads it when a task matches its description.
How do I install Twitter Reader in Codex?
Run `npx skills add himself65/finance-skills --skill twitter-reader -a codex`. Or copy the skill folder (plugins/social-readers/skills/twitter-reader in himself65/finance-skills) into .agents/skills/twitter-reader in your project. Codex loads it when a task matches its description.
Can I use Twitter Reader in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add himself65/finance-skills --skill twitter-reader -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/twitter-reader, .gemini/skills/twitter-reader, .github/skills/twitter-reader and .opencode/skills/twitter-reader in your project.
What does Twitter Reader need to run?
Going by SKILL.md and its folder, Twitter Reader needs the command-line tools its instructions call (npm). Our summary lists: Node.js.
Does Twitter Reader access the network?
SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.
Is Twitter Reader safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Twitter Reader use?
Twitter Reader is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Twitter Reader use?
About 1.9k tokens (SKILL.md is roughly 7.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.2k tokens, read only when the agent opens those files.
What are the alternatives to Twitter Reader?
Skills that share tags, products or a category with Twitter Reader: Social Content (freekmurze/dotfiles, 1k stars), Typefully (freekmurze/dotfiles, 1k stars), Changelog Social Recap (FlorianBruniaux/claude-code-ultimate-guide, 6.1k stars) and X Mastery Mentor (alchaincyf/x-mentor-skill, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Twitter Reader?
himself65 (a GitHub user) maintains it in himself65/finance-skills, which has 3,382 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 5, 2026.
Source: himself65/finance-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.