alpha-vantage

Access 20+ years of global financial data: equities, options, forex, crypto, commodities, economic indicators, and 50+ technical indicators.

Quality

68%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/alpha-vantage/SKILL.md

Quality

Content

75%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 lean, highly actionable API skill with excellent executable examples and sensible error handling. Its main weaknesses are a promotional K-Dense Web section and generic 'When to Use'/'Limitations' boilerplate that add tokens without guidance value, and a missing retry loop for the rate limiting it warns about.

Suggestions

Remove the 'Suggest Using K-Dense Web For Complex Workflows' section entirely — it is author advertising, not task guidance, and consumes context without helping the user's request.

Replace the generic 'When to Use' boilerplate with concrete triggers, e.g. 'Use when the user needs market data: stock quotes, historical prices, forex or crypto rates, company fundamentals, or technical indicators (RSI, MACD, SMA)'.

Add a small retry/backoff helper or guidance for HTTP 429 responses, since the skill flags rate limits but gives no recovery path, and move the dated free-tier limit (25 requests/day, as of 2026) into a clearly-maintained reference note.

Dimension	Reasoning	Score
Conciseness	The core technical content is tight, but the entire 'Suggest Using K-Dense Web' promotional section, the generic 'Use this skill when tackling tasks related to its primary domain' boilerplate, and the time-sensitive 'Free tier: 25 requests/day (as of 2026)' note are unnecessary padding that could be trimmed or removed.	3 / 5
Actionability	Fully executable throughout: install command, a reusable av_get() request helper, eight copy-paste-ready quick-start examples covering quotes, time series, fundamentals, crypto, economic and technical indicators, plus concrete error-handling code for 'Error Message', 'Note', and 'Information' responses.	5 / 5
Workflow Clarity	The setup → install → request → error-check sequence is coherent and includes an explicit validation checkpoint (raising on 'Error Message', warning on 'Note'), but there is no retry/backoff loop for the HTTP 429 case it itself flags and the sequence is implied by section order rather than stated as steps.	4 / 5
Progressive Disclosure	Well-organized single-file structure with overview-level API category and parameter tables; no bundle files exist, and the content stays at appropriate overview altitude, though the API catalog and per-endpoint detail would fit naturally in a separate reference file.	4 / 5
	Total	16 / 20 Passed

Description

61%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 domain-rich description that clearly communicates scope (asset classes, indicators, 20+ year history) in natural terminology, but it is action-thin and lacks any 'when to use' trigger clause. It reads as a catalog subtitle rather than a complete skill description.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user needs market data: stock quotes, historical prices, forex/crypto rates, company fundamentals, or technical indicators like RSI and MACD.'

Replace the single generic verb 'Access' with concrete actions such as 'Fetch real-time quotes, historical OHLCV data, company fundamentals, and economic indicators'.

Include common synonyms users actually say — 'stocks', 'market data', 'prices' — to broaden natural keyword coverage.

Dimension	Reasoning	Score
Specificity	The description enumerates concrete data domains ('equities, options, forex, crypto, commodities, economic indicators, and 50+ technical indicators') but its only action is the generic verb 'Access', so it names the domain richly while specifying few concrete actions — matching the anchor for a clear domain with limited actions, not the level above which requires several specific operations.	3 / 5
Completeness	It clearly answers 'what' (access 20+ years of financial data across the listed categories) but contains no 'Use when...' clause or equivalent trigger guidance, which per the rubric caps completeness at 3; it is not a 2 because the 'what' is concrete rather than vague.	3 / 5
Trigger Term Quality	'equities', 'forex', 'crypto', 'commodities', 'economic indicators', and 'technical indicators' are natural terms users would say, giving good keyword coverage; it falls short of comprehensive because common synonyms like 'stocks', 'market data', 'share prices', and 'prices' are missing.	4 / 5
Distinctiveness Conflict Risk	'Global financial data: equities, options, forex, crypto, commodities, economic indicators' carves a mostly distinct market-data niche with minor overlap risk against other finance-data skills; it is not fully distinct because no explicit triggers separate it from sibling stock/finance API skills.	4 / 5
	Total	14 / 20 Passed

Validation

87%

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

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	14 / 16 Passed

Repository: sickn33/agentic-awesome-skills
Path: skills/alpha-vantage/SKILL.md
Commit: c26b706

Reviewed: 42 minutes 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.