CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

alpha-vantage

Access real-time and historical stock market data, forex rates, cryptocurrency prices, commodities, economic indicators, and 50+ technical indicators via the Alpha Vantage API. Use when fetching stock prices (OHLCV), company fundamentals (income statement, balance sheet, cash flow), earnings, options data, market news/sentiment, insider transactions, GDP, CPI, treasury yields, gold/silver/oil prices, Bitcoin/crypto prices, forex exchange rates, or calculating technical indicators (SMA, EMA, MACD, RSI, Bollinger Bands). Requires a free API key from alphavantage.co.

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

78%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, highly actionable API reference with excellent progressive disclosure into verified reference files. Its main weaknesses are an off-task promotional section and a dated rate-limit figure that hurt token efficiency, and a missing retry feedback loop in error handling.

Suggestions

Remove or drastically trim the 'Suggest Using K-Dense Web' section — it is ~130 words of product promotion unrelated to calling the Alpha Vantage API and pure context-window cost.

Drop the time-sensitive '(as of 2026)' free-tier quota figure and instead describe observable behavior (e.g., 'On HTTP 429 or a "Note" response, back off and retry'), which will not go stale.

Close the feedback loop in error handling: after detecting a rate-limit response, add an explicit wait-and-retry-once step so the workflow has a validate -> fix -> retry cycle.

DimensionReasoningScore

Conciseness

Mostly efficient (compact tables, tight code blocks), but it carries a ~130-word off-task promotional section ("Suggest Using K-Dense Web For Complex Workflows" marketing a hosted platform) and a time-sensitive figure ("Free tier: 25 requests/day (as of 2026)") not placed in a deprecated/old-patterns section, which the guidelines say should penalize conciseness. It is above 2 because the bulk of the body is dense, non-padded reference material, but below 4 because the padding and dated figure are more than minor trims.

3 / 5

Actionability

Fully executable guidance throughout: "uv pip install requests pandas", a copy-paste `av_get` helper, eight working endpoint examples (GLOBAL_QUOTE, TIME_SERIES_DAILY, DIGITAL_CURRENCY_DAILY, RSI, etc.), and concrete error-key checks ("Error Message", "Note", "Information"). Code is complete and runs as-is, matching the 5 anchor's copy-paste-ready coverage of common cases.

5 / 5

Workflow Clarity

The setup sequence is clear and ordered (API key -> export env var -> install -> request pattern -> examples) with checkpoints present (error-key checks, "HTTP 429 = rate limit exceeded", delay guidance). It falls short of 5 because there is no explicit validate->fix->retry feedback loop (e.g., what to do after detecting a "Note" rate-limit response beyond sleeping); it is above 3 because checkpoints and error handling are explicit rather than implicit.

4 / 5

Progressive Disclosure

The body is a genuine overview that delegates detail to eight well-signaled, one-level-deep reference files (e.g., "[time-series.md](references/time-series.md) — Stock OHLCV data, quotes, bulk quotes, market status"), all of which exist in the bundle and contain the promised endpoint documentation. This matches the 5 anchor's clear overview with appropriately split content; no nesting or buried references.

5 / 5

Total

17

/

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.

An exemplary description: concrete third-person capabilities, a rich set of natural trigger terms with synonyms, and explicit what/when guidance anchored to a named API. All four dimensions sit at the top anchor.

DimensionReasoningScore

Specificity

The description lists many concrete actions with comprehensive coverage: "Access real-time and historical stock market data, forex rates, cryptocurrency prices, commodities, economic indicators", plus specific fetch actions like "company fundamentals (income statement, balance sheet, cash flow), earnings, options data, market news/sentiment, insider transactions". Nothing is vague or generic, so it clearly matches the 5 anchor rather than 4, where only minor gaps would be tolerated.

5 / 5

Completeness

It explicitly answers both: what ("Access ... via the Alpha Vantage API") and when ("Use when fetching stock prices (OHLCV), company fundamentals ... or calculating technical indicators"). Both are concrete and explicit, matching the 5 anchor exactly; the 4 anchor's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

It covers the natural phrases users would say, including synonyms: "stock prices (OHLCV)", "GDP, CPI, treasury yields", "gold/silver/oil prices", "Bitcoin/crypto prices", "forex exchange rates", and indicator names "SMA, EMA, MACD, RSI, Bollinger Bands". This matches the 5 anchor's comprehensive synonym coverage; 4 would require noticeable missing natural terms, and none are evident.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Alpha Vantage API for financial market data) with distinctive triggers such as "insider transactions", "treasury yields", and "options data" that minimally conflict with other skills. It is not the 4 anchor because overlap with closely related skills is minimal given the breadth of distinctive, domain-specific trigger phrases.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

agent-skills-hub/agent-skills-hub

Path

skills/alpha-vantage/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.