CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hybrid-search-implementation

Combine vector and keyword search for improved retrieval. Use when implementing RAG systems, building search engines, or when neither approach alone provides sufficient recall.

50

Quality

63%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/hybrid-search-implementation/SKILL.md

The canonical home for this skill is hybrid-search-implementation in rmyndharis/antigravity-skills

SKILL.md
Quality
Evals
Security

Quality

Content

32%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 an empty skeleton: boilerplate use/don't-use sections and generic instructions with zero domain substance (no hybrid search techniques, fusion methods, or code). Its single external reference points to a nonexistent file, so a reader has no way to reach actionable guidance. Needs concrete content or a real, working bundle.

Suggestions

Add concrete domain guidance in the Instructions section — e.g., a minimal runnable pattern for combining BM25 and vector scores (reciprocal rank fusion or weighted scoring) with a short code example, instead of 'Apply relevant best practices and validate outcomes'.

Fix the broken reference: either create `resources/implementation-playbook.md` with the promised detailed patterns and examples, or remove the reference entirely.

Delete the contentless 'Do not use this skill when' boilerplate and replace it with genuinely distinguishing exclusions (e.g., when pure lexical search or pure embedding search already suffices), and make 'Use this skill when' bullets actionable.

DimensionReasoningScore

Conciseness

The body is short, but the "Do not use this skill when" section ("The task is unrelated to hybrid search implementation", "You need a different domain or tool outside this scope") is empty boilerplate, and Instructions bullets like "Apply relevant best practices and validate outcomes" are filler that should be tightened or cut. Not 4 because two whole sections carry no domain-specific information.

3 / 5

Actionability

The Instructions are high-level hints ("Clarify goals, constraints, and required inputs", "Apply relevant best practices") with no concrete steps, code, or named techniques (no fusion method, no BM25/vector setup, no weighting). Matches the 'minimal concrete guidance' anchor; not 1 only because the use-case bullets and playbook pointer give minimal shape, though the pointer targets a nonexistent file.

2 / 5

Workflow Clarity

No real workflow is sequenced: generic imperatives with no concrete steps, no validation checkpoints, and no error-recovery loop. Not 1 because the bullets imply a rough order (clarify → apply → verify), but that rough sequence has major gaps, matching the anchor for a rough sequence with poorly defined steps and absent validation.

2 / 5

Progressive Disclosure

Sections are clearly labeled and the reference "If detailed examples are required, open `resources/implementation-playbook.md`" is well signaled, but that file does not exist — there is no `resources/` directory or any bundle files, so the sole path to detailed content is broken. Navigation to the actual substance fails, matching the minimal-structure anchor rather than 3, where a working but poorly organized reference would land.

2 / 5

Total

9

/

20

Passed

Description

78%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, well-formed description: explicit what and when clauses in third person, with natural trigger terms and a distinct hybrid-retrieval niche. Its only weaknesses are modest action coverage and a few missing natural synonyms (hybrid search, semantic search, BM25).

DimensionReasoningScore

Specificity

"Combine vector and keyword search for improved retrieval" names the domain plus essentially one concrete action (combining approaches for retrieval), matching the anchor for 1-2 concrete actions without comprehensive coverage. It is not 4 because it does not list several specific, distinct actions.

3 / 5

Completeness

It explicitly answers both what ("Combine vector and keyword search for improved retrieval") and when ("Use when implementing RAG systems, building search engines, or when neither approach alone provides sufficient recall") with concrete trigger phrases, matching the top anchor exactly. It is clearly not 4 because the 'when' clause is explicit and specific rather than improvable.

5 / 5

Trigger Term Quality

Natural triggers like "RAG systems", "building search engines", and "recall" are present, giving good keyword coverage. Not 5 because common variations users would say — "hybrid search", "semantic search", "BM25" — are missing.

4 / 5

Distinctiveness Conflict Risk

The hybrid-retrieval niche ("neither approach alone provides sufficient recall") is mostly distinct, but "implementing RAG systems" and "building search engines" could overlap with pure-RAG or general search-engine skills. Matches the 'mostly distinct; minor overlap risk' anchor rather than the minimal-conflict anchor 5.

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

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

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/hybrid-search-implementation/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.