twelvedata-api

Twelve Data financial API for stocks, forex, crypto, ETFs, and 100+ technical indicators. Use when fetching time series data, technical analysis, fundamentals, or real-time streaming quotes.

Quality

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/twelvedata-api/SKILL.md

Quality

Content

65%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.

Highly actionable with comprehensive executable examples, but it underuses its own bundle: the endpoint reference is inlined rather than deferred to ENDPOINTS.md, and the production client script is never mentioned. Workflow clarity is capped by missing validation around batch operations.

Suggestions

Replace the inline 'API Endpoints Reference' tables with a pointer to references/ENDPOINTS.md to avoid duplication and shrink the main skill.

Reference scripts/twelvedata_client.py from the body (e.g., a 'Production client' section) so the bundled wrapper is discoverable.

Integrate the error-handling/credit-check pattern into the batch and fundamentals recipes so each task validates responses before proceeding.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with extensive code, but the opening line restates the description and the inline API Endpoints Reference tables duplicate content that belongs in the bundled references/ENDPOINTS.md, so it could be tightened.	3 / 5
Actionability	Provides fully executable, copy-paste-ready Python covering the common cases: basic requests, SDK usage, time series, chained indicators, batch quotes, fundamentals, forex, crypto, symbol search, WebSocket, and error handling.	5 / 5
Workflow Clarity	The skill is a recipe collection rather than a sequenced workflow, and batch operations (get_batch_quotes) lack integrated validation checkpoints; the standalone error-handling snippet is not wired into the task sequences, capping clarity at 3.	3 / 5
Progressive Disclosure	Section structure is reasonable, but the bundled references/ENDPOINTS.md and scripts/twelvedata_client.py are never referenced from the body, while a partial endpoint reference is inlined instead of pointing to the existing reference file.	3 / 5
	Total	14 / 20 Passed

Description

83%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, well-formed description that clearly states both the capability set and explicit use-when triggers in third person. The main weakness is overlap risk with sibling financial-API skills on generic market-data terms.

Dimension	Reasoning	Score
Specificity	Names concrete capabilities and actions ("stocks, forex, crypto, ETFs, and 100+ technical indicators"; "fetching time series data, technical analysis, fundamentals, or real-time streaming quotes"), with only minor gaps such as symbol search and batch requests.	4 / 5
Completeness	Explicitly answers both what ("Twelve Data financial API for stocks, forex, crypto, ETFs, and 100+ technical indicators") and when ("Use when fetching time series data, technical analysis, fundamentals, or real-time streaming quotes") with concrete trigger phrases.	5 / 5
Trigger Term Quality	Includes natural terms users would say (stocks, forex, crypto, ETFs, time series, technical analysis, fundamentals, real-time streaming quotes), though a few common variants (financial data, stock prices, market data, OHLCV) are absent.	4 / 5
Distinctiveness Conflict Risk	Naming the specific provider ("Twelve Data") gives it a clear niche, but generic financial triggers (stocks, forex, time series) overlap with sibling skills like finnhub-api, alphavantage-api, and fmp-api.	4 / 5
	Total	17 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: fernandezbaptiste/Skrillz
Path: skills/twelvedata-api/SKILL.md
Commit: 93ed392

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.