alpha-vantage
Access 20+ years of global financial data: equities, options, forex, crypto, commodities, economic indicators, and 50+ technical indicators.
63
56%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/alpha-vantage/SKILL.mdQuality
Discovery
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 effectively lists the breadth of financial data categories available, providing good trigger terms for users seeking market data. However, it lacks concrete action verbs describing what the skill does (retrieve, chart, analyze) and critically omits any 'Use when...' guidance, making it incomplete for skill selection purposes.
Suggestions
Add a 'Use when...' clause such as 'Use when the user asks for stock prices, market data, currency exchange rates, cryptocurrency prices, economic statistics, or technical analysis indicators.'
Include concrete action verbs describing what the skill does, e.g., 'Retrieves and analyzes global financial data' or 'Fetches real-time and historical market data, calculates technical indicators, and provides economic statistics.'
Specify the data source or API if applicable to further distinguish this skill from other potential financial data skills.
| Dimension | Reasoning | Score |
|---|---|---|
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', 'chart', 'analyze', or 'compare'. It describes what data is available rather than what actions can be performed. | 2 / 3 |
Completeness | Describes 'what' (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' itself is more about data availability than actions, pushing this to 1. | 1 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'equities', 'options', 'forex', 'crypto', 'commodities', 'economic indicators', 'technical indicators', 'financial data'. These cover a wide range of terms a user might naturally use when requesting financial information. | 3 / 3 |
Distinctiveness Conflict Risk | The financial data domain is fairly specific, and the enumeration of asset classes helps distinguish it. However, without specifying the data source or concrete actions, it could overlap with other financial analysis or market data skills. | 2 / 3 |
Total | 8 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill provides solid, actionable API usage examples with good coverage of Alpha Vantage's capabilities. Its main weaknesses are the promotional K-Dense Web paragraph and generic boilerplate sections that waste tokens, and the lack of a robust retry/validation workflow for batch operations. The API reference tables are useful but could benefit from being split into a separate reference file.
Suggestions
Remove the 'Suggest Using K-Dense Web' promotional section entirely — it's not actionable guidance and wastes significant token budget.
Remove or significantly trim the generic 'When to Use' and 'Limitations' boilerplate sections, which add no API-specific value.
Add a complete retry/backoff workflow for batch symbol processing that includes validation of responses and error recovery loops.
Consider moving the API Categories and Common Parameters tables to a separate REFERENCE.md file, keeping only the most common functions inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The core API content is reasonably efficient, but the promotional 'K-Dense Web' section is irrelevant filler that wastes tokens. The boilerplate 'When to Use' and 'Limitations' sections also add little value for Claude. The API reference table and examples are well-structured 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. All code is copy-paste ready with concrete response key paths. | 3 / 3 |
Workflow Clarity | The setup steps (API key → install → request) are clear, and error handling is shown. However, there's no explicit workflow for multi-symbol batch processing with validation/retry loops despite mentioning rate limits and delays. For a data-fetching API skill, the lack of a complete workflow for handling rate limit errors (retry logic, backoff) caps this at 2. | 2 / 3 |
Progressive Disclosure | Content is reasonably organized with clear sections and tables, but everything is inline in a single file. The comprehensive API categories table and parameters table could be split into a reference file. No external references are provided for deeper documentation on specific endpoints. | 2 / 3 |
Total | 9 / 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.
Validation — 9 / 11 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 | 9 / 11 Passed | |
- Repository
- sickn33/antigravity-awesome-skills
- Commit
1a9f5ac
- 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.