Agent skill

Opencli Reader

by himself65 in himself65/finance-skills

Generic read-only fallback for sources opencli supports but no dedicated skill covers: finance sites (Yahoo Finance, Bloomberg, Reuters, Barchart, Eastmoney, Xueqiu, Sinafinance), communities…

MITAuto-check passedResearch & Science

Install Opencli Reader

skills CLI
$ npx skills add himself65/finance-skills --skill opencli-reader -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install himself65/finance-skills opencli-reader --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ 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/opencli-reader .claude/skills/opencli-reader && rm -rf skills-src

Use ~/.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/

Facts

Skill name
opencli-reader
GitHub stars
3.4k
Token cost
~2.9k tokens
SKILL.md length
1,140 words
Files
4 (incl. references)
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

Generic read-only fallback for sources opencli supports but no dedicated skill covers: finance sites (Yahoo Finance, Bloomberg, Reuters, Barchart, Eastmoney, Xueqiu, Sinafinance), communities…

  • Works in 7 steps: Decide Whether to Use This Skill → Ensure opencli Is Ready → Discover the Right Command → …
  • The user asks to read
  • SKILL.md covers Step 1: Decide Whether to Use…, Step 2: Ensure opencli Is Ready, Step 3: Discover the Right… and Step 4: Check the Adapter's…, plus 4 more sections
  • Calls npm

What it does

Opencli Reader is an agent skill from himself65/finance-skills. Generic read-only fallback for sources opencli supports but no dedicated skill covers: finance sites (Yahoo Finance, Bloomberg, Reuters, Barchart, Eastmoney, Xueqiu, Sinafinance), communities (Reddit, HackerNews, Weibo, Zhihu, Xiaohongshu, Bilibili), newsletters and blogs (Substack, Medium), research (arXiv, Google Scholar), podcasts and video (Apple Podcasts, Xiaoyuzhou, Spotify, YouTube), Weixin, Amazon, and more. Use it when the user asks to read or fetch from such a site — for example r/wallstreetbets, the…

Its SKILL.md is about 2.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/discovery.md` and `references/finance-sources.md`).

It sits in Research & Science, covering Academic paper search, Newsletters and Podcasting. It works with arXiv, Discord, LinkedIn and Telegram. The repository describes itself as: A collection of skills for AI financial analysis. The licence is MIT.

When your agent uses it

  • The user asks to read
  • Fetch from such a site — for example r/wallstreetbets
  • The HackerNews front page
  • Eastmoney hot stocks

Example prompts

  • “use opencli to read”
  • “/opencli-reader”

Requirements

  • Node.js

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Decide Whether to Use This Skill
  2. Ensure opencli Is Ready
  3. Discover the Right Command
  4. Check the Adapter's Strategy Before Running
  5. Execute the Command
  6. Handle Failures
  7. Present the Results

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

Opencli Reader loads about 2.9k tokens when it runs, and up to ~5.9k if it reads all its reference files. Until then it costs about 206 tokens; SKILL.md has 1,140 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~206
When it runs · the whole SKILL.md, loaded when a task matches
~2.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.9k

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). 1,140 words, ~2,853 tokens.

Download SKILL.mdSave it as .claude/skills/opencli-reader/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
opencli-reader
description
Generic read-only fallback for sources opencli supports but no dedicated skill covers: finance sites (Yahoo Finance, Bloomberg, Reuters, Barchart, Eastmoney, Xueqiu, Sinafinance), communities (Reddit, HackerNews, Weibo, Zhihu, Xiaohongshu, Bilibili), newsletters and blogs (Substack, Medium), research (arXiv, Google Scholar), podcasts and video (Apple Podcasts, Xiaoyuzhou, Spotify, YouTube), Weixin, Amazon, and more. Use it when the user asks to read or fetch from such a site — for example r/wallstreetbets, the HackerNews front page, Eastmoney hot stocks, the Xueqiu feed, Bloomberg markets headlines, or an arXiv search — or says "use opencli to read". Prefer twitter-reader, linkedin-reader, discord-reader, telegram-reader, or yc-reader when the source matches. Read-only: never runs write commands.

opencli Reader (Generic Fallback, Read-Only)

Generic fallback for any source opencli supports via its adapter registry (100+ sites, growing). Use this skill only when no dedicated finance-skill covers the source — the specialized skills (twitter-reader, linkedin-reader, discord-reader, telegram-reader, yc-reader) are always preferred when the request matches one of them.

This skill is read-only. Write commands that opencli exposes (post, like, comment, send, save, upvote, subscribe, follow, delete, reply-dm, etc.) must not be invoked.


Step 1: Decide Whether to Use This Skill

Only use this skill if the request cannot be handled by a more specific skill.

If the user asks about…Use this skill instead
Twitter/Xtwitter-reader
LinkedInlinkedin-reader
Discorddiscord-reader
Telegramtelegram-reader
Y Combinatoryc-reader
Anything else opencli supports (Yahoo Finance, Bloomberg, Reuters, Reddit, HackerNews, Eastmoney, Xueqiu, Substack, arXiv, etc.)this skill

If the source is not in opencli's registry either, stop and tell the user the request isn't covered — don't fall back to ad-hoc scraping.


Step 2: Ensure opencli Is 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 NOT_INSTALLED:

bash
npm install -g @jackwener/opencli

If SETUP_NEEDED, guide the user through Browser Bridge setup (only required for adapters whose strategy is COOKIE, HEADER, INTERCEPT, or UI — PUBLIC and LOCAL adapters work without a browser):

  1. Download the latest opencli-extension-v{version}.zip from the GitHub Releases page
  2. Unzip it, open chrome://extensions in Chrome, enable Developer mode
  3. Click Load unpacked and select the unzipped folder
  4. Make sure Chrome is logged into the target site, then re-run opencli doctor

Requires Node.js >= 20 (or Bun >= 1.0).


Step 3: Discover the Right Command

Do not guess command names or flags — the registry has 500+ commands and changes weekly. Instead:

bash
# Full registry (grouped by site), machine-readable JSON
opencli list -f json

# Filter to a site
opencli list | grep -i <site>

# Site-level help (all commands + flags)
opencli <site> --help

# Command-level help (positional args + flags + defaults)
opencli <site> <command> --help

The opencli list -f json entry for each command includes:

  • site — adapter namespace (e.g., yahoo-finance)
  • name — subcommand (e.g., quote)
  • strategy — PUBLIC / COOKIE / HEADER / INTERCEPT / UI / LOCAL — tells you if a browser login is needed
  • description, args, columns — canonical metadata

Use opencli list -f json as the source of truth. Never paste a site list into the plan from memory; adapters are added every week.

Quick map of the most common finance / research sources

The table below is a shortlist, not exhaustive — always confirm with opencli <site> --help.

SourceSite slugCommon commands
Yahoo Financeyahoo-financequote
Bloombergbloombergmarkets, economics, industries, tech, politics, opinions, news, businessweek, feeds, main
Reutersreuterssearch
Eastmoney (东方财富)eastmoneyquote, rank, kline, sectors, etf, holders, money-flow, northbound, longhu, kuaixun, convertible, index-board, announcement, hot-rank
Xueqiu (雪球)xueqiustock, hot-stock, hot, feed, comments, watchlist, search, groups, fund-snapshot, fund-holdings, earnings-date, kline
Sinafinancesinafinance(see --help)
TDX / THStdx, ths(see --help)
Barchart (options)barchartquote, options, flow, greeks
Redditreddithot, popular, frontpage, search, subreddit, read, user, user-posts, user-comments, saved
HackerNewshackernewstop, best, new, ask, show, jobs, user, search
Substacksubstackfeed, publication, search
Mediummedium(see --help)
arXivarxiv(see --help)
Google Scholargoogle-scholar(see --help)
Weiboweibo(see --help)
Bilibilibilibilihot, video + more
Xiaohongshu (小红书)xiaohongshu(see --help)
Rednote (小红书 international)rednote(see --help — mirrors xiaohongshu)
Zhihuzhihu(see --help)
Baidu Scholarbaidu-scholar(see --help)
Wanfangwanfang(see --help)
36kr36kr(see --help)
Jikejike(see --help)
Blueskybluesky(see --help)
Apple Podcastsapple-podcasts(see --help)
Xiaoyuzhou (podcasts)xiaoyuzhou(see --help)
Spotifyspotify(see --help)
YouTubeyoutube(see --help)
Weixin Official Accountweixin(see --help — drafts is read; create-draft is write)
Toutiaotoutiaoarticles
Government policy / lawgov-policy, gov-law(see --help)
Web download / readerwebread, download

For anything not listed, run opencli list -f json and filter.


Step 4: Check the Adapter's Strategy Before Running

Run opencli list -f json (or opencli <site> <command> --help) and read the strategy field:

StrategyWhat it meansPreconditions
PUBLICPure HTTP; no browser neededNone
LOCALTalks to a local endpointLocal service running
COOKIE / HEADERReuses your Chrome login for the siteChrome logged into the site + Browser Bridge extension loaded
INTERCEPTOpens an automation window to capture a signed requestSame as COOKIE; be patient — may take several seconds
UIFull DOM interactionSame as COOKIE; slowest; results depend on the site's current layout

If the user doesn't have a login and the adapter's strategy is not PUBLIC / LOCAL, tell them they need to log into the site in Chrome before retrying.


Show full SKILL.md (445 more words)Show less

Step 5: Execute the Command

General pattern
bash
opencli <site> <command> [positional-args] [flags] -f json
Universal flags
FlagEffect
-f jsonStructured JSON — always prefer this for agent processing
-f yaml / -f csv / -f md / -f table / -f plainOther formats
-vVerbose logging (also sets OPENCLI_VERBOSE=1)
--liveKeep the automation window open after the command (browser-backed adapters only)
--focusOpen the automation window in the foreground (browser-backed adapters only)

Command-specific flags (--limit, --filter, --type, etc.) are not universal — always check opencli <site> <command> --help.

Examples
bash
# Yahoo Finance quote (PUBLIC)
opencli yahoo-finance quote AAPL -f json

# Reddit hot posts in a subreddit (COOKIE or PUBLIC depending on subreddit)
opencli reddit subreddit wallstreetbets --limit 20 -f json
opencli reddit search "SPY options" --limit 15 -f json

# HackerNews top (PUBLIC)
opencli hackernews top --limit 20 -f json

# Eastmoney hot rank (PUBLIC)
opencli eastmoney hot-rank -f json

# Xueqiu hot stocks (PUBLIC or COOKIE)
opencli xueqiu hot-stock -f json
opencli xueqiu stock SH600519 -f json

# Bloomberg markets headlines (COOKIE)
opencli bloomberg markets -f json

# arXiv paper search (PUBLIC)
opencli arxiv search "volatility surface" --limit 10 -f json

# Substack feed
opencli substack feed --limit 20 -f json

# Web page → readable markdown (PUBLIC)
opencli web read "https://example.com/article" -f json
Key rules
  1. Always use opencli <site> <command> --help before constructing a command you haven't run this session — don't assume flag names.
  2. Use -f json for programmatic processing.
  3. Start with a small --limit (10–20) to validate the shape before pulling more.
  4. Check strategy before running a browser-backed adapter — if the user isn't logged in, a COOKIE / UI adapter will fail.
  5. Read-only — skip write commands. Common write command names across adapters: post, reply, comment, like, unlike, upvote, save, subscribe, unsubscribe, follow, unfollow, block, unblock, delete, bookmark, unbookmark, send, create-draft, reply-dm, accept. If you're unsure whether a command is read or write, check the description in opencli list -f json; if it suggests a mutation, skip it.

Step 6: Handle Failures

If a command returns empty or errors out, the site may have changed its selectors / API. opencli has a built-in self-repair loop:

bash
# Re-run with diagnostic context
OPENCLI_DIAGNOSTIC=1 opencli <site> <command> <args>

This emits a structured RepairContext that identifies the failing adapter's source path. Possible responses:

  1. If the user has the opencli-autofix skill installed, tell them to run that skill.
  2. If not, suggest they file an issue at https://github.com/jackwener/opencli/issues with the RepairContext output.
  3. Don't silently fall back to hand-rolled scraping — that hides the bug from the upstream registry.

Rate limits on the target site can also cause empty results; wait and retry.


Step 7: Present the Results

  1. Summarize the data for the user's actual question, don't just dump the raw JSON.
  2. Include source attribution — site name + URL for each item where available.
  3. For market data, surface price / % change / volume / market cap and flag anomalies.
  4. For news/posts, highlight headlines, timestamps, and key quotes.
  5. For research (arXiv, Scholar), include title, authors, abstract, and link.
  6. Treat browser sessions as private — never echo CDP endpoints, cookies, or auth tokens.

Reference Files

  • references/discovery.md — How to navigate opencli list, opencli <site> --help, and the JSON schema of registry entries
  • references/finance-sources.md — Detailed notes on the finance-heavy adapters (Yahoo Finance, Bloomberg, Eastmoney, Xueqiu, Barchart, Reuters, Reddit, HackerNews) and which commands are read vs write

Read these reference files when you need concrete examples for a specific site, or when the user asks for a capability not covered by one of the dedicated readers.

© 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/opencli-reader of himself65/finance-skills.

  • SKILL.md
  • README.md
  • references/discovery.md
  • references/finance-sources.md

Open the folder on GitHubat commit 01fc7b4

Compare with similar skills

Opencli 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.

Opencli Reader compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Opencli Reader this skillhimself65/finance-skills3.4k—~2.9kAutomated safety check: PassMIT
Fin Opencli Readercriptogus/agent-evolve-network288—~965Automated safety check: PassMIT
Insane Searchfivetaku/gptaku-plugins-codex128—~5.6kAutomated safety check: PassMIT
News Aggregator Skillcclank/news-aggregator-skill1.3k—~2.1kAutomated safety check: PassNone
Podcast Pipelineericosiu/ai-marketing-skills3.6k1 repos~2.6kAutomated safety check: PassMIT
Qiaomu Opencli Usagejoeseesun/qiaomu-opencli-skills993—~3kAutomated safety check: PassMIT

Similar skills

  • Fin Opencli Reader

    criptogus/agent-evolve-network

    Generic read-only fallback to read any source opencli supports (Yahoo Finance, Bloomberg, Reddit, HackerNews, arXiv, Eastmoney, Xueqiu, and 90+ more).

    288 GitHub stars~965 tokensUpdated 28 days ago
    Research & ScienceAuto-check passed
  • Insane Search

    fivetaku/gptaku-plugins-codex

    Adaptive access for blocked websites — tries every method until one works.

    128 GitHub stars~5.6k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed
  • News Aggregator Skill

    cclank/news-aggregator-skill

    Comprehensive news aggregator that fetches, filters, and deeply analyzes real-time content from 44+ sources including Hacker News, Lobsters, Dev.to, GitHub, arXiv, Hugging Face Papers, AIHOT, TLDR…

    1.3k GitHub stars~2.1k tokensUpdated 4 mo ago
    Writing & ContentAuto-check passed
  • Podcast Pipeline

    ericosiu/ai-marketing-skills

    Podcast-to-Everything content pipeline. An agent skill from ericosiu/ai-marketing-skills.

    3.6k GitHub starsUsed in 1 repo~2.6k tokens
    Writing & ContentAuto-check passed
  • Qiaomu Opencli Usage

    joeseesun/qiaomu-opencli-skills

    A skill your agent uses when running OpenCLI commands to interact with websites (Bilibili, Twitter, Reddit, Xiaohongshu, etc.), desktop apps (Cursor, Notion), or public APIs (HackerNews, arXiv).

    993 GitHub stars~3k tokensUpdated 6 mo ago
    Research & ScienceAuto-check passed
  • Literature Discovery Pipeline

    Yuan1z0825/nature-skills

    Runs a daily literature pipeline: multi-source search, six-dimension scoring, fine reading, formatted delivery to a chat channel and archival of the notes.

    46k GitHub starsUsed in 2 repos~1.2k tokens
    Research & ScienceAuto-check passed

More from himself65/finance-skills

All 19 skills in this repo
  • Company 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…

    3.4k GitHub stars~3.3k tokensUpdated 3 days ago
    Auto-check passed
  • 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…

    3.4k GitHub stars~1.4k tokensUpdated 3 days ago
    Auto-check passed
  • 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…

    3.4k GitHub stars~1.7k tokensUpdated 3 days ago
    Auto-check passed
  • 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…

    3.4k GitHub stars~1.8k tokensUpdated 3 days ago
    Auto-check passed
  • Fintel Data

    himself65/finance-skills

    Query Fintel (fintel.io) institutional market data through its REST API or official MCP server.

    3.4k GitHub stars~2.2k tokensUpdated 3 days ago
    Auto-check: notes
  • Generative UI

    himself65/finance-skills

    Design system and templates for Claude's built-in generative UI — the showwidget tool that renders interactive HTML/SVG widgets inline in claude.ai conversations.

    3.4k GitHub stars~3.1k tokensUpdated 3 days ago
    Auto-check passed

Questions about Opencli Reader

What does Opencli Reader do?

Generic read-only fallback for sources opencli supports but no dedicated skill covers: finance sites (Yahoo Finance, Bloomberg, Reuters, Barchart, Eastmoney, Xueqiu, Sinafinance), communities…. Opencli Reader is an agent skill from himself65/finance-skills. Generic read-only fallback for sources opencli supports but no dedicated skill covers: finance sites (Yahoo Finance, Bloomberg, Reuters, Barchart, Eastmoney, Xueqiu, Sinafinance), communities (Reddit, HackerNews, Weibo, Zhihu, Xiaohongshu, Bilibili), newsletters and blogs (Substack, Medium), research (arXiv, Google Scholar), podcasts and video (Apple Podcasts, Xiaoyuzhou, Spotify, YouTube), Weixin, Amazon, and more.

When should I use Opencli Reader?

Opencli Reader fits situations like: the user asks to read; fetch from such a site — for example r/wallstreetbets; the HackerNews front page; eastmoney hot stocks.

How do I install Opencli Reader in Claude Code?

Run `npx skills add himself65/finance-skills --skill opencli-reader -a claude-code`. Or copy the skill folder (plugins/social-readers/skills/opencli-reader in himself65/finance-skills) into .claude/skills/opencli-reader in your project. Claude Code loads it when a task matches its description.

How do I install Opencli Reader in Codex?

Run `npx skills add himself65/finance-skills --skill opencli-reader -a codex`. Or copy the skill folder (plugins/social-readers/skills/opencli-reader in himself65/finance-skills) into .agents/skills/opencli-reader in your project. Codex loads it when a task matches its description.

Can I use Opencli 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 opencli-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/opencli-reader, .gemini/skills/opencli-reader, .github/skills/opencli-reader and .opencode/skills/opencli-reader in your project.

What does Opencli Reader need to run?

Going by SKILL.md and its folder, Opencli Reader needs the command-line tools its instructions call (npm). Our summary lists: Node.js.

Does Opencli 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 Opencli 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 Opencli Reader use?

Opencli 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 Opencli Reader use?

About 2.9k tokens (SKILL.md is roughly 11k 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 3k tokens, read only when the agent opens those files.

What are the alternatives to Opencli Reader?

Skills that share tags, products or a category with Opencli Reader: Fin Opencli Reader (criptogus/agent-evolve-network, 288 stars), Insane Search (fivetaku/gptaku-plugins-codex, 128 stars), News Aggregator Skill (cclank/news-aggregator-skill, 1.3k stars) and Podcast Pipeline (ericosiu/ai-marketing-skills, 3.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Opencli Reader?

himself65 (a GitHub user) maintains it in himself65/finance-skills, which has 3,382 GitHub stars. The repository holds 19 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.