CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

alphavantage-api

Alpha Vantage financial API for stocks, forex, crypto, and 50+ technical indicators. Use when fetching time series data, technical analysis, fundamentals, economic indicators, or news sentiment.

Quality

83%

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

The canonical home for this skill is alphavantage-api in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 highly actionable, well-sectioned reference with executable code for every common task and correct real-world error handling. Its main weaknesses are duplicated inline content (pandas section, free/premium tier details, endpoint tables) and failure to surface the existing ENDPOINTS.md reference and alphavantage_client.py script, which both wastes tokens and hides the deeper materials.

Suggestions

Replace the ~75 lines of inline endpoint tables in 'API Functions Reference' with a brief summary plus a pointer to references/ENDPOINTS.md, e.g. 'Full endpoint parameters: See [references/ENDPOINTS.md](references/ENDPOINTS.md)'.

Mention scripts/alphavantage_client.py in the body (e.g., under Quick Start or Installation) so the bundled production client with caching/retry is discoverable instead of being shadowed by hand-rolled requests.get examples.

Merge the 'Using Python Package' and 'Usage with Pandas' sections into one, and fold the 'Free vs Premium Features' bullet list into the existing Rate Limits table to remove the duplicated content.

DimensionReasoningScore

Conciseness

The body is mostly dense tables and code with no concept over-explanation, but it carries real duplication: "Using Python Package" and "Usage with Pandas" repeat nearly identical TimeSeries/TechIndicators code, the "Free vs Premium Features" section restates the Rate Limits table, and ~75 lines of endpoint tables inline what references/ENDPOINTS.md (425 lines) already covers. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened' — above the notably-verbose 2, below the minor-trim 4.

3 / 5

Actionability

Fully executable, copy-paste-ready code covering the common cases: authentication via env var, quotes, daily data, RSI, company overview, forex, crypto, news sentiment, earnings calendar (including the CSV-format parsing detail), plus an error-handling function keyed to the API's actual response keys ("Note", "Error Message", "Information"). Specific examples cover the common cases per the anchor-5 example.

5 / 5

Workflow Clarity

The sequence is clear and unambiguous: set ALPHAVANTAGE_API_KEY → call a function with the documented params → parse the named response keys → route errors through the "Error Handling" pattern ("Note" → rate limit, "Error Message" → fail). This is a single-purpose lookup/call skill with no destructive or batch operations, so the validation cap doesn't apply. It sits at 4 rather than 5 because there are no explicit retry/backoff checkpoints for rate limits and best practices are a flat list rather than an ordered checklist with feedback loops.

4 / 5

Progressive Disclosure

Section structure is good (## Quick Start, ## API Functions Reference, ## Common Tasks, ## Error Handling), but the two bundle files are never referenced: references/ENDPOINTS.md duplicates the inline endpoint tables, and scripts/alphavantage_client.py (a 499-line production client) is completely undiscoverable. This matches the anchor 'Some structure but could be better organized; references present but not clearly signaled; content that should be separate is inline' — better than the unstructured 2, short of the 4 where bulk content lives in the separate files.

3 / 5

Total

15

/

20

Passed

Description

88%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 strong description: concrete, third-person, and comprehensive across the API's data domains, with an explicit 'Use when...' trigger clause. Its only weaknesses are a few missing natural synonyms and trigger phrases that overlap with sibling financial-API skills.

DimensionReasoningScore

Specificity

The description comprehensively covers the API's concrete capabilities: "financial API for stocks, forex, crypto, and 50+ technical indicators" plus "time series data, technical analysis, fundamentals, economic indicators, or news sentiment" — multiple specific capabilities with no vague filler. It uses third person voice and matches the anchor for comprehensive coverage of concrete capabilities; the score-4 anchor's 'minor gaps in coverage' doesn't apply since every major API domain is named.

5 / 5

Completeness

It explicitly answers both questions: what — "Alpha Vantage financial API for stocks, forex, crypto, and 50+ technical indicators"; when — "Use when fetching time series data, technical analysis, fundamentals, economic indicators, or news sentiment." This mirrors the anchor-5 example structure (clear 'what' plus explicit 'Use when...' with concrete trigger phrases), clearly above the anchor-4 case where the 'when' is only generic.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "stocks, forex, crypto, technical analysis, fundamentals, economic indicators, news sentiment, time series data" are phrases users would actually say. A few common variations are missing (e.g., "stock quotes", "prices", "market data", "exchange rates", "earnings"), which matches the anchor 'Good keyword coverage; a few natural terms missing' rather than the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

Naming "Alpha Vantage" gives a clear niche with an unambiguous brand trigger, but the 'when' triggers ("fetching time series data", "technical analysis", "fundamentals") are generic across financial-data APIs and would equally match sibling skills like finnhub-api or twelvedata-api (which the body itself lists as related). This fits 'Mostly distinct; minor overlap risk with closely related skills' rather than the minimal-conflict 5.

4 / 5

Total

18

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/alphavantage-api/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.