CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

73

Quality

90%

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.

A well-built read-only skill body: executable curl examples with exact endpoints, fields, and defaults, organized in a clear 4-step workflow with an API-key checkpoint and a properly signaled single reference file. Weak spots are mild redundancy between the body and the reference (answer patterns, cross-source blocks) and the absence of any response-error validation step.

DimensionReasoningScore

Conciseness

Largely lean — a mapping table plus copy-paste curl commands with no conceptual padding (no explanation of what sentiment or an API is). Minor fat: the opening 'Use it when the user wants' list restates the description, and Step 4's answer patterns plus the multi-source curl block partially duplicate 'references/api_reference.md'. Efficient but could be trimmed slightly.

4 / 5

Actionability

Fully executable guidance: concrete curl commands per source ('curl -s "https://api.adanos.org/reddit/stocks/v1/compare?tickers=TSLA&days=7" -H "X-API-Key: $ADANOS_API_KEY"'), exact field names ('mentions' vs 'trade_count'), explicit defaults ('days=7', '1..10 tickers'), and a copy-ready output template. Common cases (single-source, multi-source snapshot, multi-ticker) are all covered.

5 / 5

Workflow Clarity

Clear 4-step sequence (check key → map request to endpoint → execute → present) with an explicit checkpoint in Step 1 (detect ADANOS_API_KEY_MISSING and remediate). The destructive/batch cap does not apply since the skill is read-only. Not a 5 because there is no validation of API responses (error/empty/missing-source handling beyond rule 5's one-liner) and no feedback loop if a request fails.

4 / 5

Progressive Disclosure

Clear overview with a single well-signaled, one-level-deep reference: 'references/api_reference.md - endpoint guide, field meanings, and example workflows... Read the reference file when you need the exact field names, query parameters, or recommended answer patterns.' The referenced file exists, is one level deep, and the split is appropriate — compact patterns inline, full field/parameter detail in the reference.

5 / 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: concrete, third-person, platform-specific capabilities paired with an explicit and natural multi-trigger 'Use this skill whenever...' clause. Only minor gap is the single-verb action coverage, which keeps specificity just below comprehensive.

DimensionReasoningScore

Specificity

Quotes concrete capabilities: 'Fetch normalized stock sentiment across Reddit, X.com, financial news, and Polymarket... buzz score, bullish percentage, mention or trade counts, and trend' — lists several specific outputs in third person ('Fetch'). Not a 5 because the action vocabulary is a single verb ('Fetch') with no mention of comparison/detail capabilities, leaving minor coverage gaps.

4 / 5

Completeness

Explicitly answers both questions: 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 throughout. Matches the score-5 anchor; the 'when' clause is explicit and multi-trigger.

5 / 5

Trigger Term Quality

Covers natural user phrasings comprehensively: 'how much a stock is being discussed', 'how hot it is on social platforms', 'how many Reddit mentions or Polymarket bets', 'whether Reddit, X, and news agree', 'compare stock buzz and sentiment across tickers'. These are the phrases a user would naturally say; no common synonyms obviously missing.

5 / 5

Distinctiveness Conflict Risk

Clear niche (cross-platform stock sentiment via the named Adanos Finance API) with distinct triggers; the explicit boundary 'Read-only: it never places trades or modifies anything' further separates it from trading/execution skills. Minimal overlap risk.

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.