CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

exa-search

Semantic search, similar content discovery, and structured research using Exa API. Use when you need semantic/embeddings-based search, finding similar content, or searching by category (company, people, research papers, etc.).

Quality

67%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/exa-search/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a thin template: it duplicates the description as prose, provides one executable install command, and defers everything substantive — API usage, examples, troubleshooting — to an external GitHub repo. Claude reading this skill would have no idea how to actually perform an Exa search.

Suggestions

Add executable examples of actual Exa API usage (e.g., a curl or Python snippet hitting the /search endpoint with contents/category filters) so the skill's core function is usable without leaving the bundle.

Replace 'Configure Exa API key' with concrete configuration steps, e.g., the exact environment variable name (EXA_API_KEY) and where to set it.

Bundle the examples and troubleshooting content currently deferred to the GitHub repo into local reference files (e.g., references/examples.md, references/troubleshooting.md) and link them from the body instead of external URLs.

DimensionReasoningScore

Conciseness

The body is short and avoids concept over-explanation, but the Overview and 'When to Use' sections restate the frontmatter description verbatim and 'Use naturally in Claude Code conversations' adds nothing — mostly efficient with some redundant boilerplate that could be tightened. Not 2 because there is no padding via explanations of known concepts; not 4 because several sections are pure filler.

3 / 5

Actionability

The only executable guidance is the install command `npx skills add -g BenedictKing/exa-search`; 'Configure Exa API key' gives no env-var name or method, and there is zero code or API usage for the skill's actual function (Exa searches) — high-level hints missing the specific steps to execute. Not 3 because no partial or pseudocode guidance for the core task exists at all.

2 / 5

Workflow Clarity

The three steps ('Install the skill', 'Configure Exa API key', 'Use naturally in Claude Code conversations') form a rough sequence but are poorly defined — configuration has no instructions and step 3 is vacuous — with no checkpoints. Not 3 because the steps are too vague to constitute even an implicit validation-bearing sequence.

2 / 5

Progressive Disclosure

Section headers are clear and pointers are explicitly signaled ('See GitHub Repository for examples', 'See the GitHub repository for troubleshooting guides'), but all substantive content is deferred to an external URL rather than any bundled reference file (references/, scripts/, assets/ are absent), leaving the bundle hollow. Not 2 because references are clearly signaled rather than buried; not 4 because essential content has no appropriate home within the skill.

3 / 5

Total

10

/

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 description: it names concrete capabilities, includes an explicit 'Use when...' trigger clause with natural keywords, and clearly delineates the semantic-search niche. Its only weaknesses are the unexpanded 'structured research' capability and a few missing trigger synonyms.

DimensionReasoningScore

Specificity

Names the domain (Exa API) and several concrete actions — "Semantic search, similar content discovery, and structured research" plus category search — matching the 'several specific actions; minor gaps' anchor. Not 5 because 'structured research' is never concretized, leaving minor coverage gaps.

4 / 5

Completeness

Explicitly answers both 'what' (semantic search, similar content discovery, structured research using Exa API) and 'when' ("Use when you need semantic/embeddings-based search, finding similar content, or searching by category...") with concrete trigger phrases, matching the top anchor. The 'when' clause is already explicit and specific, so the 4-anchor ('could be more explicit') does not fit.

5 / 5

Trigger Term Quality

Includes natural phrases users would say — "semantic search", "finding similar content", "searching by category (company, people, research papers)" — giving good keyword coverage with a few natural synonyms missing (e.g., 'find similar sites', 'neural search').

4 / 5

Distinctiveness Conflict Risk

"semantic/embeddings-based search" carves a clear niche distinct from generic web search, but the skill family includes closely related search skills (tavily-web, firecrawl-scraper), creating minor overlap risk — mostly distinct rather than a fully isolated niche.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/exa-search/SKILL.md

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.