CtrlK
BlogDocsLog inGet started
Tessl Logo

firstdata

Find official portals, APIs, and download paths for authoritative primary data sources (governments, international organizations, research institutions, etc.). Use when users need to know "where to find this data from an official source", "which source is more authoritative", or "how to cite primary data". Covers 1000+ global data sources with authority comparison and site navigation guidance.

56

Quality

67%

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

Quality

Discovery

100%

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 is a strong skill description that clearly communicates its purpose, provides explicit trigger scenarios via a 'Use when' clause with natural user phrases, and occupies a distinct niche. The description is concise yet comprehensive, covering specific actions (finding portals, APIs, download paths), scope (1000+ global sources), and supplementary capabilities (authority comparison, citation guidance, site navigation).

DimensionReasoningScore

Specificity

Lists multiple concrete actions: 'Find official portals, APIs, and download paths', 'authority comparison', and 'site navigation guidance'. Also specifies the types of sources covered (governments, international organizations, research institutions).

3 / 3

Completeness

Clearly answers 'what' (find official portals, APIs, download paths with authority comparison and navigation guidance) and 'when' (explicit 'Use when' clause with three specific trigger scenarios). Both dimensions are well-covered.

3 / 3

Trigger Term Quality

Includes natural phrases users would say: 'where to find this data from an official source', 'which source is more authoritative', 'how to cite primary data'. Also includes relevant keywords like 'portals', 'APIs', 'download paths', 'official', 'authoritative', 'primary data sources'.

3 / 3

Distinctiveness Conflict Risk

Occupies a clear niche around finding authoritative/official data sources, which is distinct from general data analysis, web search, or document processing skills. The focus on authority comparison and primary source identification makes it unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Implementation

35%

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

This skill provides useful reference information about the FirstData MCP server and its tools, but suffers from significant verbosity and organizational issues. Large sections (What FirstData Is, Typical Queries table, Description Quality Guidelines, Community) add little actionable value for Claude. The tool documentation is detailed on limitations but lacks concrete invocation examples showing actual parameters and responses.

Suggestions

Remove or drastically shorten the 'What FirstData Is', 'Typical Queries', 'Description Quality Guidelines', and 'Community' sections — these waste tokens on context Claude doesn't need to perform the task.

Add concrete tool invocation examples with actual parameters and expected response structures for at least `search_source` and `ask_agent` (e.g., show the exact tool call for finding China GDP data and what the response looks like).

Move the detailed MCP Tools Reference (with all limitations) to a separate reference file and keep only a brief tool selection decision tree in the main SKILL.md.

Add an explicit workflow with decision points: e.g., 'Start with search_source for keyword queries → if results insufficient, escalate to ask_agent → verify source details with get_source → optionally get_access_guide for navigation help'.

DimensionReasoningScore

Conciseness

The skill is extremely verbose with significant unnecessary content. The 'What FirstData Is' section explains concepts Claude doesn't need (what a data navigator is, what primary sources are). The 'Typical Queries' table, 'Description Quality Guidelines' section, and 'Community' section are all unnecessary padding. The coverage bullet list and capabilities section largely repeat information Claude can infer from the tool descriptions.

1 / 3

Actionability

The Quick Start section provides concrete MCP configuration commands and JSON config, which is good. The MCP Tools Reference documents real limitations and parameters. However, there are no executable end-to-end examples showing actual tool invocations with specific parameters and expected responses — the tool descriptions are reference-style rather than showing concrete usage patterns with real input/output.

2 / 3

Workflow Clarity

There's an implicit workflow (configure → authenticate → select tool → use tool) but no explicit sequenced workflow with validation checkpoints. The skill doesn't clearly guide through error recovery (e.g., what to do when quota is exhausted, when authentication fails, or when search returns no results). The tool selection guidance ('browse the tool list and select the appropriate tool') is vague rather than providing a clear decision tree.

2 / 3

Progressive Disclosure

There is one reference to a separate file (references/firstdata-register.md) and an external README link, which is good. However, the main SKILL.md contains too much inline content that could be split out — the full MCP tools reference with all limitations could be a separate reference file, and the Description Quality Guidelines section doesn't belong in the main skill file at all. The bundle has no files provided to verify the referenced path exists.

2 / 3

Total

7

/

12

Passed

Validation

72%

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

Validation8 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

8

/

11

Passed

Repository
MLT-OSS/FirstData
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.