opencli-reader

Generic read-only fallback for any source opencli covers but this repo has no dedicated reader for — Yahoo Finance, Bloomberg, Reuters, Barchart, Eastmoney, Xueqiu, Sinafinance, Reddit, HackerNews, Substack, Medium, Weibo, Bilibili, Xiaohongshu, Zhihu, arXiv, Google Scholar, Apple Podcasts, Xiaoyuzhou, Spotify, YouTube, Weixin, Amazon, and more. Triggers: "use opencli to read", "grab the frontpage from hackernews", "read reddit r/wallstreetbets", "fetch Eastmoney hot stocks", "pull Xueqiu feed", "get Bloomberg markets headlines", "search arXiv for", any request to read from a site where a specialized skill does not exist but opencli does. FALLBACK — prefer twitter-reader, linkedin-reader, discord-reader, telegram-reader, or yc-reader when the source matches. READ-ONLY — never invoke write operations.

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Critical

Do not install without reviewing

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-structured, actionable workflow with concrete commands, a clear step sequence, and a failure-recovery loop, supported by two appropriately scoped reference files. Its only weakness is mild verbosity in the inline source shortlist, which slightly inflates token usage without harming clarity.

Suggestions

Tighten the ~46-row source-mapping table: collapse the many '(see --help)' rows into a single note and keep only rows that name concrete commands, reducing inline token cost.

Move the per-site command shortlist (e.g., Bloomberg/Eastmoney/Xueqiu command enumerations) fully into references/finance-sources.md, leaving SKILL.md with the discovery pattern and a pointer.

Consider condensing Step 2's environment-status block and install steps, since Claude can derive the install command from the NOT_INSTALLED branch.

Dimension	Reasoning	Score
Conciseness	Largely efficient with tables and code blocks that earn their place and no over-explanation of concepts Claude already knows, though the ~46-row source shortlist and a few prose passages could be trimmed slightly. Fits the 'efficient; minor instances that could be trimmed' anchor, above the midpoint but not fully lean.	4 / 5
Actionability	Provides copy-paste-ready commands throughout (install, list, --help, quote, search, diagnostic re-run) covering the common cases, with the general pattern and universal flags explicitly stated. Fully executable guidance.	5 / 5
Workflow Clarity	Seven clearly sequenced steps from decision through presentation, with checkpoints (check strategy before running, run --help before constructing) and an explicit failure feedback loop via OPENCLI_DIAGNOSTIC=1 and RepairContext. The skill is read-only, so the destructive/batch validation cap does not apply.	5 / 5
Progressive Disclosure	SKILL.md is an overview with two well-signaled, one-level-deep reference files (discovery.md, finance-sources.md), both real and described in a Reference Files section; bulk detail is pushed to references while the shortlist stays inline for quick lookup.	5 / 5
	Total	19 / 20 Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is exemplary: it states the capability, gives concrete trigger phrases a user would naturally say, and explicitly signals its fallback role and precedence over specialized readers. It is concise yet comprehensive with minimal conflict risk.

Dimension	Reasoning	Score
Specificity	Names the domain (generic read-only fallback for opencli sources) and lists multiple concrete actions (read, grab, fetch, pull, search) across a comprehensive set of named sources, matching the 'comprehensive coverage' anchor.	5 / 5
Completeness	Clearly answers 'what' (read-only fallback for sources lacking a dedicated reader) and 'when' (explicit Triggers plus FALLBACK precedence guidance), matching the anchor for explicitly answering both with concrete trigger phrases.	5 / 5
Trigger Term Quality	Explicit 'Triggers:' block with natural user phrases such as 'grab the frontpage from hackernews', 'read reddit r/wallstreetbets', and 'search arXiv for', giving comprehensive coverage of terms users would actually say.	5 / 5
Distinctiveness Conflict Risk	Defines a clear niche (fallback only when no dedicated reader exists) and explicitly defers to five named specialized skills, minimizing conflict risk with closely related readers.	5 / 5
	Total	20 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: himself65/finance-skills
Path: plugins/social-readers/skills/opencli-reader/SKILL.md
Commit: 81e1f50

Reviewed: 7 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.