CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

finance-sentiment

Fetch normalized stock sentiment across Reddit, X.com, financial news, and Polymarket from the Adanos Finance API: buzz score, bullish percentage, mention or trade counts, and trend. Use this skill whenever the user asks how much a stock is being discussed or how hot it is on social platforms, how many Reddit mentions or Polymarket bets a company has, whether Reddit, X, and news agree, or wants to compare stock buzz and sentiment across tickers. Read-only: it never places trades or modifies anything.

75

Quality

94%

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

86%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 lean, actionable four-step workflow with concrete curl examples, a request-matching table, and a well-signaled single reference file that carries the bulk API detail. Weaknesses are minor: some repeated instructions (read-only/no-trades, prefer-compare-endpoints) could be consolidated, and there is no error-recovery guidance for failed API responses.

Suggestions

Consolidate the repeated guidance: state 'read-only, never trade' and 'prefer compare endpoints' once in the Key rules list instead of three times and in three places respectively.

Add a brief error-recovery checkpoint in Step 3 for failed responses, e.g., a 401 means re-check that ADANOS_API_KEY is set, and an empty source payload should be reported as 'no data'.

Trim the duplicated 'Use it when' bullet list (which restates the frontmatter description) or the Step 4 presentation patterns that are repeated verbatim in references/api_reference.md, keeping only what differs.

DimensionReasoningScore

Conciseness

The body is efficient and assumes competence, but has minor trimmable redundancy: read-only/no-trading is stated three times ("This skill is read-only", "Never execute trades or convert the result into trading instructions", "not trade instructions") and "Prefer compare endpoints" appears in Step 2, Step 3, and Key rule 1. Not anchor 5 because those repeats mean not every token earns its place; above anchor 3 because the padding is minor with no explanation of concepts Claude already knows.

4 / 5

Actionability

Fully executable copy-paste curl commands with the X-API-Key header and concrete query params, a request-to-endpoint mapping table naming the exact fields, a working env-var probe, and a concrete output template. Examples cover the common cases (single-source, multi-source snapshot, multi-ticker), matching the anchor-5 example pattern.

5 / 5

Workflow Clarity

A clear four-step sequence (ensure API key → identify need → execute → present) with an explicit validation checkpoint: the ADANOS_API_KEY probe branches to remediation ("If ADANOS_API_KEY_MISSING, ask the user to set..."). Not anchor 5 because there is no recovery guidance for failed API responses (e.g., 401 or HTTP errors after execution); above anchor 3 because the key check is an explicit checkpoint with a feedback path, and the read-only nature means no destructive/batch validation cap applies.

4 / 5

Progressive Disclosure

Well-organized sections keep the body at quick-start level while a single one-level-deep reference (references/api_reference.md, verified to exist) is clearly signaled with its contents ("endpoint guide, field meanings, and example workflows") and an explicit read trigger ("when you need the exact field names, query parameters, or recommended answer patterns"). Not anchor 4 because the split is appropriate and navigation is easy, with no buried or nested references.

5 / 5

Total

18

/

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 a model example: it states concrete capabilities with named sources and data fields, provides explicit 'Use this skill when...' triggers phrased in natural user language, and delimits scope (read-only, no trades). It scores at the top anchor on every dimension with no fluff or over-claims.

DimensionReasoningScore

Specificity

"Fetch normalized stock sentiment across Reddit, X.com, financial news, and Polymarket from the Adanos Finance API: buzz score, bullish percentage, mention or trade counts, and trend" names the API, all four sources, and the concrete data fields returned — comprehensive coverage of the skill's concrete actions. Not anchor 4 because the coverage of the fetch capability and its outputs is complete rather than having minor gaps.

5 / 5

Completeness

Explicitly answers both what ("Fetch normalized stock sentiment... buzz score, bullish percentage, mention or trade counts, and trend") and when ("Use this skill whenever the user asks...") with concrete trigger phrases, matching the anchor-5 example pattern. Not anchor 4 because the 'when' clause is fully explicit with specific trigger scenarios rather than merely present.

5 / 5

Trigger Term Quality

Natural user phrasings are comprehensively covered: "how much a stock is being discussed", "how hot it is on social platforms", "how many Reddit mentions or Polymarket bets a company has", "whether Reddit, X, and news agree", "compare stock buzz and sentiment across tickers", plus terms like buzz, bullish, trend, and tickers. Not anchor 4 because common synonyms are present rather than a few missing.

5 / 5

Distinctiveness Conflict Risk

A clear niche (stock sentiment via the Adanos Finance API across named platforms) with distinct triggers and an explicit boundary ("Read-only: it never places trades or modifies anything") gives minimal conflict risk. Uses third person ("Fetch"), so no voice penalty; not anchor 4 because the platform-specific triggers make overlap with other skills unlikely.

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

Path

plugins/data-providers/skills/finance-sentiment/SKILL.md

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.