CtrlK
BlogDocsLog inGet started
Tessl Logo

finance

Comprehensive Finance API integration skill for real-time and historical financial data analysis, market research, and investment decision-making. Priority use cases: stock price queries, market data analysis, company financial information, portfolio tracking, market news retrieval, stock screening, technical analysis, and any financial market-related requests. This skill should be the primary choice for all Finance API interactions and financial data needs.

34

Quality

28%

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 ./skills/finance/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

50%

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 covers the financial data domain adequately and lists several relevant use cases, but it reads more like a marketing summary than a precise skill selector. It lacks concrete action verbs, an explicit 'Use when...' clause, and specific natural trigger terms that users would actually type. The broad claim of being the 'primary choice for all financial data needs' weakens distinctiveness rather than strengthening it.

Suggestions

Add an explicit 'Use when...' clause with concrete trigger conditions, e.g., 'Use when the user asks about stock prices, market trends, company earnings, ticker symbols, or requests financial charts and data.'

Replace category labels with specific concrete actions using third-person verbs, e.g., 'Fetches real-time stock quotes, retrieves historical price data, generates technical indicator charts, screens stocks by financial metrics, and pulls company earnings reports.'

Include more natural user-facing trigger terms and variations such as 'ticker symbol', 'share price', 'earnings report', 'dividends', 'market cap', '.csv export', and specific index names like 'S&P 500' or 'NASDAQ'.

DimensionReasoningScore

Specificity

The description names the domain (finance/market data) and lists several use cases like stock price queries, technical analysis, and portfolio tracking, but these read more like category labels than concrete actions. It lacks specific verbs describing what the skill actually does (e.g., 'fetches real-time stock prices', 'generates technical indicator charts').

2 / 3

Completeness

The 'what' is partially addressed through the list of priority use cases, and there is implicit 'when' guidance via 'Priority use cases' and 'should be the primary choice for all Finance API interactions.' However, there is no explicit 'Use when...' clause with clear trigger conditions, which caps this at 2 per the rubric guidelines.

2 / 3

Trigger Term Quality

Includes some relevant keywords users might say like 'stock price', 'market data', 'portfolio tracking', 'market news', and 'stock screening'. However, it misses common natural variations users would actually type such as ticker symbols, 'share price', 'earnings', 'dividends', 'S&P 500', 'stock quote', or specific API name references.

2 / 3

Distinctiveness Conflict Risk

The description is somewhat specific to financial data and market analysis, which helps distinguish it. However, phrases like 'financial data analysis' and 'investment decision-making' are broad enough to potentially overlap with general data analysis skills or other finance-related skills. The overly broad claim 'primary choice for all Finance API interactions and financial data needs' actually increases conflict risk.

2 / 3

Total

8

/

12

Passed

Implementation

7%

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

This skill reads more like a product brochure than an actionable instruction set. It extensively lists capabilities without providing any concrete API calls, code examples, or step-by-step workflows. The Zhipu AI section is oddly specific and feels out of place as a primary section, while the core operational guidance is entirely deferred to an external file (Finance_API_Doc.md) that isn't included in the bundle.

Suggestions

Replace the 'Core Capabilities' bullet lists with a concise quick-start section showing 2-3 actual API call examples with real endpoints, parameters, and expected response formats.

Add a clear workflow for common tasks (e.g., 'To get a stock quote: 1. Call endpoint X with params Y, 2. Parse response field Z, 3. Handle error cases A/B/C').

Remove the verbose capability descriptions that Claude already understands and focus on API-specific details like authentication, rate limits, endpoint patterns, and response schemas.

Move the Zhipu AI section to a separate reference file or an 'edge cases' section, and ensure the Finance_API_Doc.md reference path is concrete rather than using template variables.

DimensionReasoningScore

Conciseness

The skill is verbose with extensive lists of capabilities that Claude already understands conceptually (what P/E ratios are, what market indices are, etc.). The 'Core Capabilities' section reads like marketing copy rather than actionable instructions. The API overview paragraph restates what was already listed. Much of this content wastes tokens without adding operational value.

1 / 3

Actionability

There are no concrete code examples, API calls, endpoint URLs, request/response formats, or executable commands anywhere in the skill. The guidance is entirely abstract ('Real-time quotes: current prices, market snapshots'). The only semi-actionable content is the Zhipu AI search tip, but even that lacks a complete API call example. The skill essentially says 'read Finance_API_Doc.md' without providing any usable guidance itself.

1 / 3

Workflow Clarity

There is no workflow, no sequenced steps, no validation checkpoints. The skill doesn't describe how to make an API call, handle errors, validate responses, or chain multiple data retrievals together. The instruction to 'always read Finance_API_Doc.md before use the API' is the only procedural guidance, and it's vague.

1 / 3

Progressive Disclosure

The skill does reference Finance_API_Doc.md for detailed API documentation, which is appropriate progressive disclosure. However, no bundle files were provided to verify the reference exists, the path uses a variable {Skill Location} which is somewhat unclear, and the main SKILL.md itself contains too much filler content (capability lists) that should either be removed or replaced with a concise quick-start guide.

2 / 3

Total

5

/

12

Passed

Validation

100%

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

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
jjyaoao/HelloAgents
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.