CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

alpha-vantage

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

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

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

SKILL.md
Quality
Evals
Security

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 strongly actionable with executable code, a clear request pattern, and explicit error/rate-limit handling, organized in clean sections. Its main weaknesses are a promotional third-party section and circular boilerplate that waste tokens, plus dated rate-limit details.

Suggestions

Delete the 'Suggest Using K-Dense Web For Complex Workflows' promotional section — it is unrelated to the skill's function and consumes context without helping the user query Alpha Vantage.

Replace the circular 'When to Use' boilerplate with concrete trigger guidance (e.g. 'Use for stock quotes, historical OHLCV, fundamentals, forex/crypto rates, or technical indicators').

Move the dated rate-limit numbers ('25 requests/day (as of 2026)') and the full function-category table into a separate reference file (e.g. references/api-catalog.md), keeping SKILL.md as a lean overview.

DimensionReasoningScore

Conciseness

The body is mostly lean code and tables, but contains unnecessary padding: the promotional 'Suggest Using K-Dense Web For Complex Workflows' section, the circular boilerplate 'When to Use' section ('Use this skill when tackling tasks related to its primary domain or functionality as described above'), the description repeated verbatim under the H1, and dated rate-limit info ('25 requests/day (as of 2026)') outside any deprecated section. This fits 'mostly efficient but includes some unnecessary explanation'; not 2 because the bulk of the content is tight and code-focused.

3 / 5

Actionability

Fully executable, copy-paste-ready guidance: env-var key setup, a reusable av_get() helper, seven working examples covering the common cases (GLOBAL_QUOTE, TIME_SERIES_DAILY, OVERVIEW, INCOME_STATEMENT, DIGITAL_CURRENCY_DAILY, REAL_GDP, RSI), a parameter table, and concrete error-handling code. Matches the 'fully executable; covers the common cases' anchor.

5 / 5

Workflow Clarity

The setup-to-request sequence is clear (get key → export env var → install → request pattern → examples) with an explicit error-handling section and rate-limit guidance (429 handling, 'Note' responses, time.sleep between requests). Not 5 because the validation and error checks are presented as separate sections rather than woven into a validate→fix→retry loop; not 3 because most checkpoints are explicitly present.

4 / 5

Progressive Disclosure

No bundle files exist, so the ~125-line single file is judged on its own structure: well-labeled sections with a compact API-categories table serving as the overview. Fits 'good structure; most content appropriately placed; minor organization gaps'. Not 5 because the file exceeds the under-50-lines simple-skill case and the categories/parameters tables are reference-like material that could live in a separate reference file.

4 / 5

Total

16

/

20

Passed

Description

53%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 clearly communicates a multi-asset-class financial data capability with concrete domain enumeration, but it is missing any 'Use when...' trigger guidance and omits the most natural user terms like 'stock' and 'market data'. Adding an explicit trigger clause and common synonyms would lift completeness and trigger-term quality.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user asks for stock prices, historical market data, forex/crypto rates, economic indicators, or technical indicators like RSI or MACD.'

Include natural synonyms users actually say — 'stock', 'stock price', 'market data', 'GDP', 'interest rates' — alongside the current domain list.

State the concrete actions available (fetch quotes, download historical OHLCV data, pull fundamentals) rather than the single generic verb 'Access'.

DimensionReasoningScore

Specificity

The single action verb 'Access' is generic, but the enumeration 'equities, options, forex, crypto, commodities, economic indicators, and 50+ technical indicators' makes the scope concrete. It sits between anchor 2 (generic actions) and 4 (lists several specific actions) — concrete domains, but only one action.

3 / 5

Completeness

The 'what' is clear (access 20+ years of financial data across the listed asset classes), but there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. Not 2, because the 'what' half is specific and unambiguous.

3 / 5

Trigger Term Quality

Relevant keywords like 'forex', 'crypto', 'commodities', and 'technical indicators' are present, but common user phrasings such as 'stock', 'stock price', 'market data', and 'GDP' are missing. This matches 'some relevant keywords but missing common variations or synonyms', not the near-complete coverage of a 4.

3 / 5

Distinctiveness Conflict Risk

The multi-asset market-data niche (options, commodities, economic indicators) is mostly distinct with only minor overlap risk against other finance-data skills. Not 5, because it lacks distinct trigger phrases and does not name the provider, so it could overlap with other financial-data skills.

4 / 5

Total

13

/

20

Passed

Validation

87%

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

CriteriaDescriptionResult

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

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.