CtrlK
BlogDocsLog inGet started
Tessl Logo

build-with-exa

Build applications and agents with Exa's API: search, contents extraction, answer, Agent API, monitors, websets, OpenAI-compatible endpoints, and exa-py/exa-js SDKs. Use when choosing Exa endpoints, writing Exa API calls, integrating semantic web search or research into products, or debugging Exa request shapes.

71

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

A tightly written, highly actionable overview that avoids teaching known concepts and splits detail appropriately across 13 real, well-indexed reference files. Its only weaknesses are rule duplication between the gated-fields and Critical Pitfalls sections and the absence of inline error-recovery loops.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive with no explanations of concepts Claude already knows, but several rules (maxAgeHours/publishedDate handling, highlights/maxCharacters defaults, numResults boilerplate, category gating) are restated nearly verbatim in both the gated-fields section and Critical Pitfalls, and the decision workflow overlaps between prose bullets and the numbered list. The duplication could be trimmed or consolidated.

4 / 5

Actionability

Install commands, an auth env var with both accepted header forms, a concrete recommended JSON request, and copy-paste-ready Python, TypeScript, and curl examples fully cover the common /search case. Endpoint-selection rules are concrete and conditional rather than abstract.

5 / 5

Workflow Clarity

The 9-item endpoint decision list is a clear, well-sequenced procedure with explicit conditions, and agent guidance includes a terminal-status checkpoint ('wait for a terminal status via polling or SSE and check how the run ended before reading output'). However, there are no inline error-recovery feedback loops for failed requests or partial results, which are relegated to reference files.

4 / 5

Progressive Disclosure

SKILL.md is a genuine overview: quick start, decision rules, pitfalls, and a Reference Files table indexing all 13 reference files with topic descriptions. Every referenced file exists on disk, references are one level deep, and inline pointers like 'See Structured Output in references/search.md' are clearly signaled.

5 / 5

Total

18

/

20

Passed

Description

88%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 that explicitly covers both what the skill does and when to use it, with comprehensive, concrete capability enumeration and dense natural trigger terms. Its only gaps are a few missing synonyms and one provider-agnostic trigger clause that creates minor overlap risk with other web-search skills.

DimensionReasoningScore

Specificity

'Build applications and agents with Exa's API: search, contents extraction, answer, Agent API, monitors, websets, OpenAI-compatible endpoints, and exa-py/exa-js SDKs' comprehensively enumerates the concrete surfaces, and the trigger clause names concrete actions (choosing endpoints, writing API calls, integrating search, debugging request shapes). This matches the comprehensive-coverage anchor rather than the minor-gaps anchor below it.

5 / 5

Completeness

It explicitly answers both: what ('Build applications and agents with Exa's API: search, contents extraction, answer, Agent API, monitors, websets, OpenAI-compatible endpoints, and exa-py/exa-js SDKs') and when ('Use when choosing Exa endpoints, writing Exa API calls, integrating semantic web search or research into products, or debugging Exa request shapes') with concrete trigger phrases, exactly matching the top anchor.

5 / 5

Trigger Term Quality

Natural terms are strong — 'Exa', 'semantic web search', 'research', 'API calls', 'debugging', plus SDK package names exa-py/exa-js — but a few natural synonyms users say are missing (crawling/livecrawl, 'neural search', the legacy 'Metaphor' branding). Good coverage with a few gaps fits the 4 anchor better than comprehensive synonym coverage at 5.

4 / 5

Distinctiveness Conflict Risk

Nearly every clause is Exa-branded, giving a clear niche, but the trigger 'integrating semantic web search or research into products' is provider-agnostic and could fire for generic web-search integration tasks that other search-API skills also cover. This is minor overlap risk with closely related skills (anchor 4) rather than minimal conflict risk (anchor 5).

4 / 5

Total

18

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
stevenknowswhy/ProfessionalBuyer
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.