xai-financial-integration

Integrate xAI Grok sentiment with FinnHub, Twelve Data, Alpha Vantage, and FMP financial APIs. Use when combining social sentiment with price data, fundamentals, and news for comprehensive analysis.

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/xai-financial-integration/SKILL.md

Quality

Content

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

An actionable, real-world code skill with genuine executable examples and decent sectioning, weakened by heavy function-to-function repetition, absent response validation, and a failure to reference the bundled script that duplicates the inlined code.

Suggestions

Reference the existing scripts/financial_sentiment.py from the body (e.g. 'For a class-based implementation, see scripts/financial_sentiment.py') and keep only a representative example inline, rather than inlining eight near-identical functions.

Add response validation/checkpoints: check API responses for error payloads or rate-limit codes before passing data to Grok, especially in the batch multi_asset loop.

Consolidate the eight functions into one parameterized template plus a short table of the per-use-case JSON shapes to cut the ~450 lines substantially while preserving coverage.

Dimension	Reasoning	Score
Conciseness	The body avoids explaining concepts Claude already knows, but ~450 lines present eight near-identical functions (fetch from API -> call grok-4-1-fast -> return JSON) that repeat the same long prompt-template pattern and could be condensed into one parameterized template.	3 / 5
Actionability	Concrete, mostly copy-paste-ready Python hitting real API endpoints (finnhub.io, financialmodelingprep.com, api.twelvedata.com, api.x.ai) with env-var wiring, but missing error handling, pip-install guidance, and consistent imports (datetime is imported mid-function).	4 / 5
Workflow Clarity	The Quick Start provides a clear numbered sequence (get price, get fundamentals, get sentiment) but there are no validation checkpoints: API responses are never checked for errors/rate limits, and the batch multi_asset loop has no verification before acting on results.	3 / 5
Progressive Disclosure	Section headers (Architecture, Quick Start, Integration Functions, Dashboard, Environment Setup) give some structure, but a 15KB bundle script (scripts/financial_sentiment.py) exists and is never referenced from the body while equivalent code is inlined, leaving content that has a home stranded inline.	3 / 5
	Total	13 / 20 Passed

Description

78%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 description with an explicit 'Use when' trigger clause, concrete API and data-type names, and third-person voice. It is held back from the top tier by relying on a single generic action verb rather than enumerating several specific capabilities.

Dimension	Reasoning	Score
Specificity	The description names concrete data sources ('xAI Grok sentiment with FinnHub, Twelve Data, Alpha Vantage, and FMP financial APIs', 'price data, fundamentals, and news') but relies on a single combining action verb ('Integrate'/'combining ... for comprehensive analysis') rather than listing several distinct concrete actions.	3 / 5
Completeness	It explicitly answers both 'what' ('Integrate xAI Grok sentiment with ... financial APIs') and 'when' with a concrete 'Use when combining social sentiment with price data, fundamentals, and news for comprehensive analysis' trigger clause.	5 / 5
Trigger Term Quality	Good keyword coverage across API names (FinnHub, Twelve Data, Alpha Vantage, FMP) and data types (social sentiment, price data, fundamentals, news) that a user would naturally mention, though a few natural synonyms (e.g. 'stock sentiment', 'trading signals') are absent.	4 / 5
Distinctiveness Conflict Risk	The multi-API integration framing carves a mostly distinct niche, but it overlaps with the closely related 'xai-stock-sentiment' and the individual single-API skills listed under Related Skills.	4 / 5
	Total	16 / 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/xai-financial-integration/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.