CtrlK
BlogDocsLog inGet started
Tessl Logo

opencli-reader

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.

74

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%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.

A well-engineered body: fully executable discovery and example commands, a coherent seven-step workflow with strategy-awareness and a genuine failure-recovery loop, and verified one-level-deep references. The main weaknesses are mild redundancy — an oversized site table with many content-free '(see --help)' rows that duplicates the reference file, a repeated write-command list, and one non-executable template block in Step 2.

Suggestions

Trim the Step 3 site table to the sources with known commands and point the '(see --help)' tail at references/finance-sources.md or `opencli list -f json`, removing ~20 rows that duplicate the reference file and the description.

State the write-command exclusion once (e.g., keep only Key rule 5's enumerated list) and reference it from the read-only banner, and rewrite the Step 2 readiness check as a plain executable bash block instead of the `!`(...)` template artifact.

DimensionReasoningScore

Conciseness

Efficient and dense — commands, tables, and rules with essentially no explanation of concepts Claude already knows. Kept below 5 by padding: roughly twenty site-table rows carry no information beyond a slug ("(see `--help`)"), the source list duplicates both the frontmatter description and references/finance-sources.md, and the write-command list is stated twice (the read-only banner and Key rule 5).

4 / 5

Actionability

Copy-paste-ready commands throughout ("opencli yahoo-finance quote AAPL -f json", "opencli reddit subreddit wallstreetbets --limit 20 -f json"), a strategy/precondition table, universal-flag table, and twelve concrete examples covering the common cases, plus exact discovery commands to resolve the rest. The Step 2 readiness check uses a non-executable template artifact rather than plain bash, but the embedded command is directly runnable — a blemish, not a gap that drops it to anchor 4's 'minor gaps'.

5 / 5

Workflow Clarity

A clear seven-step sequence (decide → ensure ready → discover command → check strategy → execute → handle failures → present) with explicit checkpoints: readiness via `opencli doctor`, strategy check before browser-backed adapters, small `--limit` validation runs, and a full failure feedback loop (OPENCLI_DIAGNOSTIC=1 → autofix skill / file an issue / never scrape ad-hoc, plus rate-limit retry). The skill is read-only, so the destructive/batch validation cap does not apply.

5 / 5

Progressive Disclosure

Good structure: the body is a step-wise overview and the two reference files (references/discovery.md, references/finance-sources.md) exist, are one level deep, and are clearly signaled with an annotated description of each. Not a 5 because the 33-row site table inlines per-site detail that overlaps references/finance-sources.md — content that should live in the separate file is partially inline in SKILL.md.

4 / 5

Total

18

/

20

Passed

Description

95%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.

A strong description that states a precise niche (generic read-only fallback for opencli-covered sources), enumerates covered sites across categories, gives concrete example triggers and the explicit phrase "use opencli to read", and cleanly disambiguates against the dedicated reader skills. The only limitation is a narrow action vocabulary (read/fetch), which is inherent to the skill's fallback-reader purpose rather than a drafting flaw.

DimensionReasoningScore

Specificity

Names concrete actions ("read or fetch", "read-only fallback") and concrete example targets ("r/wallstreetbets, the HackerNews front page, Eastmoney hot stocks, the Xueqiu feed, Bloomberg markets headlines, or an arXiv search"), with the source scope enumerated specifically. Not a 5 because the action set is narrow — read/fetch only, inherent to a fallback reader — leaving minor coverage gaps versus the 'comprehensive concrete actions' anchor.

4 / 5

Completeness

Explicitly answers both what ("Generic read-only fallback for sources opencli supports but no dedicated skill covers") and when ("Use it when the user asks to read or fetch from such a site... or says 'use opencli to read'") with concrete trigger phrases, matching the anchor-5 example. Not below 5: neither half is vague or merely implied.

5 / 5

Trigger Term Quality

Comprehensive natural terms users would actually say: site names across categories (Reddit, HackerNews, Bloomberg, arXiv, Xueqiu, Substack, Spotify, YouTube), subreddit-style phrasing, and the explicit voice trigger "use opencli to read". Anchor 4 is ruled out because both synonyms (e.g., Xiaohongshu/Rednote, Chinese and English names) and concrete query examples are covered.

5 / 5

Distinctiveness Conflict Risk

Clear niche with minimal conflict risk: it explicitly defers to sibling skills ("Prefer twitter-reader, linkedin-reader, discord-reader, telegram-reader, or yc-reader when the source matches") and states its own fallback-only role, so it is unlikely to trigger for the wrong skill.

5 / 5

Total

19

/

20

Passed

Validation

100%

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
Reviewed

Table of Contents

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.