CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

search-specialist

Expert web researcher using advanced search techniques and synthesis. Masters search operators, result filtering, and multi-source verification. Handles competitive analysis and fact-checking. Use for deep research, information gathering, or trend analysis.

Quality

73%

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

Quality

Content

60%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 lays out a serviceable research workflow with some tool-specific details (allowed_domains/blocked_domains) and explicit verification steps, but about a third of it is generic filler and the guidance lacks concrete artifacts such as example queries. Verification ('Verify key facts across multiple sources') and contradiction tracking keep workflow clarity solid despite the vague spots.

Suggestions

Delete the boilerplate 'Use this skill when', 'Do not use this skill when', and generic 'Instructions' sections — they restate the frontmatter and add no actionable guidance, tightening conciseness.

Add a concrete example query showing the techniques in action (e.g., '"exact phrase" -unwanted site:example.com') and show the actual allowed_domains/blocked_domains syntax so the strategies are executable rather than descriptive.

Add an error-recovery step to the Approach, e.g., 'If initial queries return weak results, reformulate with broader terms or different operators before concluding the information is unavailable.'

DimensionReasoningScore

Conciseness

The guidance sections (Search Strategies, Approach, Output) are lean lists, but roughly a third of the body is generic boilerplate — 'Working on search specialist tasks or workflows', 'Apply relevant best practices and validate outcomes' — that teaches Claude nothing new. Fits 'mostly efficient but includes some unnecessary explanation or could be tightened'; not 2 because it never explains concepts Claude already knows.

3 / 5

Actionability

Some concrete guidance exists — 'allowed_domains for trusted sources', 'blocked_domains to exclude unreliable sites', 'Create 3-5 query variations', 'Use specific phrases in quotes for exact matches' — but there are no example queries or executable commands, and steps like 'Target specific timeframes for recent/historical data' and 'Parse structured data from pages' omit key details. Fits 'some concrete guidance but incomplete; missing key details'; not 4 because the gaps exceed minor.

3 / 5

Workflow Clarity

The Approach section gives a clear 5-step sequence ('Search broadly first, then refine' → 'Verify key facts across multiple sources' → 'Track contradictions and consensus') with an explicit verification step, fitting 'clear sequence with most checkpoints present'. Not 5 because there is no error-recovery guidance for weak results or conflicting sources.

4 / 5

Progressive Disclosure

Well-organized sections with headers and appropriately inline, self-contained content; no bundle files exist and none are referenced, so nothing is misplaced. Minor organization gaps from the boilerplate 'Use this skill when' / 'Do not use this skill when' sections keep it at 'good structure; minor organization gaps' rather than a fully clean 5.

4 / 5

Total

14

/

20

Passed

Description

75%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 solid description that names the web-research domain, several capability areas, and an explicit 'Use for' trigger clause in third person. Its main weaknesses are moderately abstract action language ('advanced search techniques', 'synthesis') and a trigger list missing common natural phrasings such as 'web search' or 'look up'.

Suggestions

Replace vague phrases like 'advanced search techniques and synthesis' with concrete operations, e.g., 'formulates precise search queries, filters results by domain and timeframe, and cross-checks claims across multiple sources'.

Expand the trigger list with natural user phrasings such as 'web search', 'research this topic', 'look this up', and 'verify this claim', alongside the existing 'deep research, information gathering, or trend analysis'.

Make the 'when' clause more explicit about user intents, e.g., 'Use when the user asks to research a topic, verify a claim, compare sources, or analyze trends.'

DimensionReasoningScore

Specificity

Lists several specific actions — 'Masters search operators, result filtering, and multi-source verification', 'Handles competitive analysis and fact-checking' — matching 'several specific actions; minor gaps in coverage', though 'advanced search techniques and synthesis' is vague filler. Not 5 because the actions are capability categories rather than concrete operations; not 3 because well more than 1-2 concrete actions are named.

4 / 5

Completeness

Both parts are explicitly present in third person: the what ('Masters search operators, result filtering, and multi-source verification') and the when ('Use for deep research, information gathering, or trend analysis'). The when names three triggers but could be more explicit about user intents (e.g., 'when the user asks to research a topic or verify a claim'), fitting the 4 anchor rather than the fully concrete trigger phrasing of a 5.

4 / 5

Trigger Term Quality

Includes natural phrases users would actually say — 'deep research', 'information gathering', 'trend analysis', 'fact-checking'. Coverage is good but common variations like 'web search', 'look this up', or 'research this topic' are missing, fitting 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

Carves a clear web-research niche ('Expert web researcher using advanced search techniques', 'multi-source verification') with mostly distinct triggers, but 'information gathering' is generic and 'competitive analysis' / 'fact-checking' could overlap with dedicated skills — minor overlap risk with closely related skills. Not 5 because conflict risk is not minimal.

4 / 5

Total

16

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

rmyndharis/antigravity-skills

Path

skills/search-specialist/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.