CtrlK
BlogDocsLog inGet started
Tessl Logo

linkedin-reader

Read LinkedIn for financial research through opencli: the user's feed, and job search with location, seniority, job type, remote, company, and date filters. Use this skill whenever the user wants to check their LinkedIn feed, see what professionals or analysts are posting about a company, market, or earnings, gauge professional sentiment, or search finance and trading jobs on LinkedIn. Read-only: it cannot post, like, comment, connect, message, or apply.

70

Quality

85%

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

71%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-structured, actionable skill body with a clean step sequence and exemplary use of a single one-level-deep reference file. Its main weaknesses are redundancy — duplicated error/setup tables and thrice-repeated `doctor` instructions — and a non-executable status-check block in Step 1 that slightly undermines both conciseness and the validation entry point.

Suggestions

Merge the "Common setup issues" table and the "Error Reference" table into one diagnostics section (they share ~60% of their rows: Extension not connected, No session, AuthRequiredError) and drop the separate Step 5 Diagnostics section, which only repeats `opencli doctor`.

Replace or remove the non-executable `!`(command -v opencli ...) 2>/dev/null || ...` status block in Step 1 — either present it as a plain instruction ("run `command -v opencli && opencli doctor` to check readiness") or as an actual runnable snippet.

Resolve the `{version}` placeholder in the extension download step (e.g., "download the latest opencli-extension-*.zip from Releases") so the setup path is copy-paste ready.

DimensionReasoningScore

Conciseness

Mostly efficient tables and command blocks, but redundancy goes beyond minor: the "Common setup issues" table and the "Error Reference" table repeat the same rows (Extension not connected, No session, AuthRequiredError), and `opencli doctor` is explained three separate times (Step 1, Step 5, and the error tables). The mangled `!`(command -v opencli...)` status block adds noise without executable value. Not 4: this is more than trimmable instances — whole duplicated sections could be consolidated.

3 / 5

Actionability

Concrete, mostly copy-paste-ready commands throughout: `npm install -g @jackwener/opencli`, `opencli linkedin timeline --limit 20 -f json`, and search examples with real flag combinations, plus exact output columns. Not 5: the Step 1 "Current environment status" block uses broken `!`(...)` pseudo-syntax that is not executable, and the extension download link carries an unresolved `{version}` placeholder. Not 3: everything else is real, runnable CLI syntax with specific examples covering the common cases.

4 / 5

Workflow Clarity

Clear five-step sequence (setup check → identify need → execute → present → diagnostics) with `opencli doctor` as an explicit validation checkpoint and an error cause/fix table forming a feedback loop. Not 5: the entry-point validation (Step 1) relies on the broken status-check block, and diagnostics are spread across Step 1, Step 5, and the error table rather than one coherent checkpoint. Not 3: sequence and error-recovery paths are present and explicit.

4 / 5

Progressive Disclosure

The body is a well-organized overview pointing to a single real, one-level-deep reference (`references/commands.md` — verified present), clearly labeled with its contents ("all flags, research workflows, and usage examples") and an explicit when-to-read instruction. Not 4: the split is appropriate — overview and common cases inline, exhaustive flag detail in the reference — with no buried or nested references.

5 / 5

Total

16

/

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 uses third-person voice, enumerates concrete capabilities with a full filter list, provides an explicit "Use this skill whenever..." trigger clause with natural user phrasings, and cleanly bounds scope as read-only. It matches the rubric's good examples in both structure and specificity.

DimensionReasoningScore

Specificity

"Read LinkedIn for financial research through opencli: the user's feed, and job search with location, seniority, job type, remote, company, and date filters" lists multiple concrete actions (feed reading, job search with six named filters) and the "Read-only: it cannot post, like, comment, connect, message, or apply" clause scopes capability boundaries — comprehensive coverage, matching the level-5 anchor. Not 4: there are no meaningful gaps; both read operations and their filter surface are fully enumerated.

5 / 5

Completeness

Explicitly answers both: the what ("Read LinkedIn... feed, and job search with location, seniority, job type, remote, company, and date filters") and the when ("Use this skill whenever the user wants to check their LinkedIn feed...") with concrete trigger phrases — the level-5 anchor verbatim structure. Not 4: the when-clause is explicit and enumerates multiple trigger scenarios, not merely implied.

5 / 5

Trigger Term Quality

Natural user phrases are covered comprehensively: "check their LinkedIn feed", "see what professionals or analysts are posting about a company, market, or earnings", "gauge professional sentiment", "search finance and trading jobs on LinkedIn" — these are the exact phrasings a user would say. Not 4: no common variation within the skill's scope (feed reading, professional sentiment, finance job search) is missing.

5 / 5

Distinctiveness Conflict Risk

"LinkedIn" plus "financial research", "professional sentiment", and "finance and trading jobs" carves out a clear niche with minimal overlap risk against generic research or job-search skills. Not 4: the triggers are platform-specific and use-case-specific, so no closely related skill would be wrongly selected.

5 / 5

Total

20

/

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.