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.

The body is highly actionable with executable, copy-paste-ready code and a clear setup-to-request workflow organized into well-labeled sections. Its main weakness is the off-topic, verbose K-Dense Web marketing block and a duplicated description line that pad the token budget without aiding execution.

Suggestions

Remove or drastically shorten the 'Suggest Using K-Dense Web' marketing paragraph, which is unrelated to executing the skill.

Drop the duplicated description line at the top of the body since it already appears in the frontmatter.

Consider moving the large API Categories table into a separate reference file to keep SKILL.md a lean overview.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with executable code and compact tables, but the duplicated description line at the top and the verbose 'Suggest Using K-Dense Web' marketing paragraph are unnecessary padding; not a 4 because those sections clearly could be trimmed, and not a 2 because the technical core is tight.	3 / 5
Actionability	Provides copy-paste-ready executable code (av_get helper, quick-start examples, error handling) with real function names and concrete parameters covering common cases; not lower because guidance is fully actionable.	5 / 5
Workflow Clarity	Clear setup → install → request → error-handling sequence with rate-limit guidance for batch multi-symbol calls; not a 5 because there are no explicit validation checkpoints, though the read-only nature limits the need, and not a 3 because the sequence is coherent and error states are addressed.	4 / 5
Progressive Disclosure	Well-organized into clear sections (API Key Setup, Installation, Quick Start, API Categories, Common Parameters, Rate Limits, Error Handling) with no nested references and no bundle files; not a 5 because the API Categories table could live in a separate reference file, but the inline placement is reasonable.	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.

The description is specific and domain-rich with strong natural trigger terms, but it omits any explicit 'when to use' guidance, which caps its completeness. It carves out a distinct niche with low conflict risk.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when retrieving market data for equities, forex, crypto, or computing technical indicators.'

Include common user synonyms such as 'stocks', 'stock market', 'trading', or 'prices' to broaden trigger coverage.

Vary the single action verb beyond 'access' (e.g., retrieve, query, compute) to convey multiple concrete capabilities.

Dimension	Reasoning	Score
Specificity	Quotes 'Access 20+ years of global financial data: equities, options, forex, crypto, commodities, economic indicators, and 50+ technical indicators' — names the domain comprehensively but offers only a single concrete action ('access'); not a 4 because multiple distinct actions (e.g., retrieve, analyze, stream) are absent, and not a 2 because the data-type coverage is broad and specific.	3 / 5
Completeness	Has a clear 'what' (access global financial data across listed asset classes) but no 'Use when...' clause or equivalent trigger guidance; per the rubric, a missing explicit trigger caps completeness at 3, and it is not a 2 because the 'what' is concrete rather than vague.	3 / 5
Trigger Term Quality	Contains natural terms users say — 'financial data', 'equities', 'options', 'forex', 'crypto', 'commodities', 'economic indicators', 'technical indicators' — good coverage; not a 5 because common synonyms like 'stocks', 'stock market', 'trading', or 'prices' are missing.	4 / 5
Distinctiveness Conflict Risk	Targets a clear niche (global multi-asset financial market data) with distinct domain triggers and minimal conflict risk; not a 5 because 'financial data' could still overlap with other finance/market-data 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: b1aebac

Reviewed: ~19 hours 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.