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

75%

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 ./skills/alpha-vantage/SKILL.md
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.

A highly actionable, well-structured single-file skill with executable code and thorough error and quota handling. Its weaknesses are mild redundancy — the Error Handling section restates logic already in the helper — and generic filler in 'When to Use' and 'Limitations' that adds tokens without adding skill-specific value.

Suggestions

Delete or merge the 'Error Handling' section: its checks duplicate the error/quota handling already implemented in av_get, and it slightly contradicts the helper by printing warnings instead of raising.

Replace the boilerplate 'When to Use' sentence with skill-specific triggers (e.g., when the user asks for stock quotes, fundamentals, FX rates, or economic data).

Trim generic filler lines in 'Limitations' (e.g., 'Do not treat the output as a substitute for...') and keep only Alpha-Vantage-specific caveats.

DimensionReasoningScore

Conciseness

The body is mostly efficient — compact tables, a lean request helper, no explanation of concepts Claude already knows — but it could be tightened: the 'Error Handling' section duplicates checks already built into av_get, and 'When to Use' plus parts of 'Limitations' are generic boilerplate filler. Not 2 because padding is limited to a few short sections; not 4 because the duplication and filler are noticeable.

3 / 5

Actionability

Fully executable, copy-paste-ready guidance: a complete av_get helper with key-redaction and error handling, quick-start examples spanning quotes, time series, fundamentals, income statements, crypto, economic indicators, and technical indicators, plus install and API-key-setup commands. The examples cover the common cases comprehensively.

5 / 5

Workflow Clarity

A clear sequence runs from key setup through installation, request pattern, examples, parameters, and rate limits, with validation checkpoints embedded in the helper (HTTP status, error/quota keys, JSON shape). Not 5 because there is no explicit cache-first/retry feedback loop despite the rate-limit discussion; not 3 because checkpoints are present, not merely implicit. The skill is read-only (non-destructive), so the destructive-cap rule does not apply.

4 / 5

Progressive Disclosure

A single-file skill with well-organized sections and the API reference compressed into compact tables rather than inlined as prose. No bundle files exist, and none are strictly required. Not 5 because the ~140-line body exceeds the simple-skill threshold and endpoint detail (e.g., the 50+ technical indicators) could be offloaded to a one-level-deep reference file; not 3 because structure and placement are good, not mixed with content that clearly belongs elsewhere.

4 / 5

Total

16

/

20

Passed

Description

66%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 specific, domain-rich description that clearly states what the skill provides, but it entirely lacks a 'Use when...' trigger clause, leaving the 'when to use' half unanswered. Adding natural user phrases like 'stock prices' and 'market data' plus an explicit trigger clause would round it out.

Suggestions

Append a trigger clause such as 'Use when the user needs stock quotes, historical prices, company fundamentals, forex rates, crypto prices, or economic data.'

Add natural synonyms users would say — 'stock prices', 'market data', 'exchange rates', 'ticker' — to broaden trigger matching.

Name the data provider (Alpha Vantage) in the description to further disambiguate from other financial-data skills.

DimensionReasoningScore

Specificity

The single concrete action 'Access 20+ years of global financial data' is backed by a comprehensive enumeration of asset classes (equities, options, forex, crypto, commodities, economic indicators) and '50+ technical indicators'. Not 5 because only one action verb is given (no fetch/analyze/quote-style actions); not 3 because coverage of the domain is comprehensive rather than partial.

4 / 5

Completeness

It clearly answers 'what' (access 20+ years of global financial data across the listed categories) but has no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 2 because the 'what' is concrete and detailed, not vague.

3 / 5

Trigger Term Quality

Natural domain keywords like 'equities', 'forex', 'crypto', 'commodities', 'economic indicators', and 'technical indicators' match what users would say. Not 5 because common variations users actually say — 'stock prices', 'market data', 'exchange rates', 'ticker' — are missing; not 3 because keyword coverage is good rather than partial.

4 / 5

Distinctiveness Conflict Risk

The niche (global financial market data access) is clear and would rarely trigger for an unrelated skill. Not 5 because without explicit trigger phrases it could still overlap with other market-data or finance skills; not 3 because it is far more specific than 'somewhat specific'.

4 / 5

Total

15

/

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

sickn33/agentic-awesome-skills

Path

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.