alpha-vantage-automation
Automate Alpha Vantage tasks via Rube MCP (Composio). Always search tools first for current schemas.
Install with Tessl CLI
npx tessl i github:haniakrim21/everything-claude-code --skill alpha-vantage-automation62
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Discovery
22%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This description is too vague and lacks the specificity needed for effective skill selection. It fails to explain what Alpha Vantage tasks can be automated (stock quotes, historical data, forex, crypto?) and provides no guidance on when Claude should choose this skill. The procedural note about searching tools is internal guidance that doesn't help with skill selection.
Suggestions
Replace 'Automate Alpha Vantage tasks' with specific capabilities like 'Fetch stock quotes, historical prices, forex rates, and crypto data via Alpha Vantage API'
Add a 'Use when...' clause with natural trigger terms like 'stock prices', 'market data', 'financial quotes', 'Alpha Vantage', or 'trading information'
Remove or relocate the procedural guidance ('Always search tools first') as it doesn't help with skill selection and belongs in the skill body instead
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language like 'Automate Alpha Vantage tasks' without specifying what tasks (stock quotes, financial data, market analysis, etc.). 'Always search tools first' is procedural guidance, not a capability description. | 1 / 3 |
Completeness | Partially addresses 'what' (automate Alpha Vantage tasks) but very weakly. Completely missing a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Includes 'Alpha Vantage', 'Rube MCP', and 'Composio' which are relevant technical terms, but lacks natural user keywords like 'stock data', 'market prices', 'financial API', or 'trading data' that users would actually say. | 2 / 3 |
Distinctiveness Conflict Risk | 'Alpha Vantage' and 'Rube MCP (Composio)' provide some distinctiveness for this specific integration, but 'automate tasks' is generic and could overlap with other automation or financial data skills. | 2 / 3 |
Total | 6 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured skill that efficiently teaches Alpha Vantage automation via Rube MCP. It excels at workflow clarity with explicit validation steps and progressive disclosure with good organization. The main weakness is that tool call examples are structural templates rather than fully concrete, executable examples with realistic sample data.
Suggestions
Add one complete end-to-end example with realistic values (e.g., fetching stock quote for 'AAPL') showing actual tool responses and how to handle them
Include a concrete example of handling pagination tokens mentioned in pitfalls
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, avoiding unnecessary explanations of what Alpha Vantage or APIs are. Every section serves a purpose and assumes Claude's competence with MCP tools and API workflows. | 3 / 3 |
Actionability | Provides concrete tool call patterns with specific parameters, but uses pseudocode-style blocks rather than fully executable code. The examples show structure but aren't copy-paste ready since they depend on dynamic values without showing complete realistic examples. | 2 / 3 |
Workflow Clarity | Clear 3-step workflow with explicit sequencing (discover → check connection → execute). Includes validation checkpoint (verify ACTIVE status before executing) and the Known Pitfalls section provides error prevention guidance. | 3 / 3 |
Progressive Disclosure | Well-organized with clear sections progressing from prerequisites to setup to workflow to pitfalls. External reference to Composio docs is one level deep and clearly signaled. Quick reference table provides efficient navigation for common operations. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
- 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.