CtrlK
BlogDocsLog inGet started
Tessl Logo

alpha-vantage

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

50

Quality

56%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/antigravity-awesome-skills-claude/skills/alpha-vantage/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

64%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a solid API reference skill with excellent actionability—executable code examples, real response key paths, and a useful helper function. However, it's weighed down by promotional content (K-Dense Web section) and generic boilerplate (When to Use, Limitations) that waste tokens. The workflow could be strengthened with explicit validation/retry patterns for batch operations, and the extensive reference tables would benefit from being split into separate files.

Suggestions

Remove the 'Suggest Using K-Dense Web' promotional section and the generic 'When to Use' / 'Limitations' boilerplate—these waste tokens and don't help Claude use the API.

Add an explicit batch workflow with retry logic: fetch → check for errors/rate limits → retry with backoff → validate response structure → proceed to next symbol.

Extract the API categories table and common parameters into a separate REFERENCE.md file, keeping only the most common functions inline in SKILL.md.

DimensionReasoningScore

Conciseness

The core API content is reasonably efficient, but the 'Suggest Using K-Dense Web' section is promotional filler unrelated to the skill's purpose, and the 'When to Use' and 'Limitations' sections are generic boilerplate that Claude already knows. The API categories table and common parameters are useful reference material but could be slightly tighter.

2 / 3

Actionability

Provides fully executable Python code for the base request pattern, multiple quick-start examples covering different API categories, error handling, and rate limit management. The helper function and examples are copy-paste ready with real API response key paths.

3 / 3

Workflow Clarity

The setup steps (API key → install → base pattern → examples) are logically sequenced. Error handling is provided but not integrated into a workflow with explicit validation checkpoints. For batch operations across multiple symbols, there's a rate limit delay mention but no explicit retry/feedback loop for error recovery.

2 / 3

Progressive Disclosure

Content is reasonably well-organized with clear sections and tables, but everything is in a single monolithic file with no references to supporting files. The comprehensive API categories table and 50+ technical indicators could benefit from being split into reference files. No bundle files exist to offload detailed content.

2 / 3

Total

9

/

12

Passed

Description

47%

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 benefits from strong domain-specific trigger terms covering multiple financial asset classes, which would help Claude match user queries about financial data. However, it lacks concrete actions beyond 'Access' and critically omits any 'Use when...' guidance, making it incomplete for reliable skill selection. Adding explicit trigger conditions and specific capabilities (e.g., retrieve prices, calculate indicators, plot charts) would significantly improve it.

Suggestions

Add a 'Use when...' clause specifying trigger conditions, e.g., 'Use when the user asks for stock prices, market data, currency exchange rates, cryptocurrency prices, or technical analysis.'

Replace the vague 'Access' with specific concrete actions such as 'Retrieves historical and real-time prices, calculates technical indicators, fetches economic calendar data.'

Mention the data source or API if applicable to further distinguish this skill from other financial tools.

DimensionReasoningScore

Specificity

Names the domain (financial data) and lists data categories (equities, options, forex, crypto, commodities, economic indicators, technical indicators), but doesn't describe concrete actions like 'retrieve', 'analyze', 'chart', or 'compare' — it only says 'Access'.

2 / 3

Completeness

It describes 'what' at a high level (access financial data) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per the rubric, a missing 'Use when...' clause caps completeness at 2, and the 'what' is also weak (only 'access'), so this scores a 1.

1 / 3

Trigger Term Quality

Includes many natural keywords users would say: equities, options, forex, crypto, commodities, economic indicators, technical indicators, and 'financial data'. These cover a broad range of terms a user might naturally use when requesting financial information.

3 / 3

Distinctiveness Conflict Risk

The financial data domain with specific asset classes provides some distinctiveness, but 'Access financial data' is broad enough that it could overlap with other financial analysis, charting, or market research skills. The lack of specific actions or triggers increases conflict risk.

2 / 3

Total

8

/

12

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation9 / 11 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

9

/

11

Passed

Repository
sickn33/antigravity-awesome-skills
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.