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

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/alpha-vantage/SKILL.md

The canonical home for this skill is alpha-vantage in sickn33/agentic-awesome-skills

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 examples and a clear setup sequence, well-organized into navigable sections. The main weakness is promotional/filler content (the K-Dense Web section and generic 'When to Use') that adds tokens without aiding task execution.

Suggestions

Remove or relocate the 'Suggest Using K-Dense Web' promotional section; it is off-skill padding that inflates the token budget.

Replace the generic 'When to Use' boilerplate with skill-specific guidance on choosing endpoints and handling batch symbol processing.

Add an explicit validation checkpoint for batch requests (e.g. check response for 'Note'/'Error Message' and back off on 429 before continuing).

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient with executable snippets and compact tables, but the 'Suggest Using K-Dense Web' promotional paragraph and the generic 'When to Use' filler are non-skill padding that could be trimmed, fitting the 3-anchor more than the 4.	3 / 5
Actionability	The body provides a copy-paste-ready av_get helper plus runnable examples covering common cases (GLOBAL_QUOTE, TIME_SERIES_DAILY, OVERVIEW, INCOME_STATEMENT, DIGITAL_CURRENCY_DAILY, REAL_GDP, RSI) with real function names and parameters, matching the 5-anchor.	5 / 5
Workflow Clarity	There is a clear setup-to-request sequence with numbered API-key steps plus rate-limit and error handling guidance, but batch (multi-symbol) operations lack an explicit validate-response-before-proceeding checkpoint, leaving a minor validation gap versus the 5-anchor.	4 / 5
Progressive Disclosure	Content is well-organized into clearly headed sections (Quick Start, API Categories, Common Parameters, Rate Limits, Error Handling) with no nested references and no bundle files present; minor organization gaps versus the 5-anchor keep it at 4.	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 about data coverage and occupies a clear niche, but it omits any explicit 'when to use' trigger guidance and leans on a single action verb. Adding a 'Use when...' clause and more natural trigger terms would raise it.

Suggestions

Add a 'Use when...' clause with concrete triggers, e.g. 'Use when the user needs stock quotes, forex rates, crypto prices, economic indicators, or technical analysis.'

Use natural terms users actually say ('stocks', 'market data', 'prices') alongside 'equities'.

Include a second concrete action verb such as 'retrieve' or 'analyze' to broaden the specificity of actions.

Dimension	Reasoning	Score
Specificity	The description names the domain and lists concrete data categories ('equities, options, forex, crypto, commodities, economic indicators, and 50+ technical indicators') but relies on a single action verb ('Access'), so it does not list several distinct concrete actions as the 4-anchor requires.	3 / 5
Completeness	It clearly answers 'what' (access global financial data across listed asset classes) but has no 'Use when...' clause or equivalent trigger guidance, which per the rubric caps completeness at 3.	3 / 5
Trigger Term Quality	Natural terms like 'forex', 'crypto', 'commodities', and 'economic indicators' are present, giving good keyword coverage, though common variations such as 'stocks', 'market data', and 'prices' are missing, keeping it just below 5.	4 / 5
Distinctiveness Conflict Risk	The Alpha Vantage financial-data niche is clearly distinct with minimal conflict risk, but the absence of explicit trigger phrases leaves minor overlap with other finance skills, fitting the 4-anchor rather than 5.	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: administrakt0r/AI-Agents-Safe-Coding-Skills
Path: plugins/AI-Agents-Safe-Coding-Skills/skills/alpha-vantage/SKILL.md
Commit: 900c504

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