finnhub-api

FinnHub financial data API integration for stocks, forex, crypto, news, and fundamentals. Use when fetching real-time quotes, company profiles, financial statements, insider trading, earnings calendars, or market news.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

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.

Highly actionable with strong executable examples and a useful error-handling loop, but it underuses its own bundle files — inlining endpoint tables instead of pointing to ENDPOINTS.md and never mentioning the production client script.

Suggestions

Replace the inlined 'API Endpoints Reference' tables with a brief summary and a link to references/ENDPOINTS.md to avoid duplication and reduce token load.

Add a section pointing to scripts/finnhub_client.py as the production-ready wrapper so Claude reaches for it instead of rewriting the boilerplate shown inline.

Tighten the opening paragraph and 'Free vs Premium' lists to the non-obvious facts, since the endpoint tables and pricing link already convey most of it.

Dimension	Reasoning	Score
Conciseness	Mostly efficient code blocks, but the opening line restates the description and ~50 lines of endpoint tables are inlined even though references/ENDPOINTS.md already holds the full reference, so it could be tightened per the 3 anchor.	3 / 5
Actionability	Abundant copy-paste-ready executable Python covering quotes, candles, calendars, news, financials, WebSocket, and error handling, matching the 5 anchor for fully executable common-case examples.	5 / 5
Workflow Clarity	A simple API skill with a real feedback loop in error handling (429 -> sleep 60s -> retry), but no explicit sequenced workflow with validation checkpoints, sitting between the 4 and 5 anchors.	4 / 5
Progressive Disclosure	Has section structure, but the body inlines endpoint tables that duplicate references/ENDPOINTS.md and never references either bundle file (ENDPOINTS.md or scripts/finnhub_client.py), fitting the 3 anchor where content that should be separate is inline and references are not clearly signaled.	3 / 5
	Total	15 / 20 Passed

Description

92%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, third-person description that clearly states capabilities and explicit usage triggers with concrete financial-data actions. Only minor gap is missing a few natural synonyms and ticker/extension variations users might say.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions across named domains: 'fetching real-time quotes, company profiles, financial statements, insider trading, earnings calendars, or market news' — comprehensive coverage matching the 5 anchor.	5 / 5
Completeness	Explicitly answers both 'what' ('FinnHub financial data API integration for stocks, forex, crypto, news, and fundamentals') and 'when' ('Use when fetching real-time quotes...') with concrete trigger phrases, matching the 5 anchor.	5 / 5
Trigger Term Quality	Good natural keywords (real-time quotes, company profiles, financial statements, earnings calendars, market news) but missing common synonyms and file extensions a user might say (e.g., 'stock price', 'ticker'), fitting the 4 anchor above the 3.	4 / 5
Distinctiveness Conflict Risk	Names FinnHub explicitly and scopes to a clear financial-data niche with distinct triggers, giving minimal conflict risk with other skills per the 5 anchor.	5 / 5
	Total	19 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: fernandezbaptiste/Skrillz
Path: skills/finnhub-api/SKILL.md
Commit: 93ed392

Reviewed: 1 day 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.