CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

wigolo-find-similar

Hybrid semantic discovery — fuses embeddings + keyword search + live web search via 3-way Reciprocal Rank Fusion. Use when the user has a good source and wants more like it, says "find similar", "related pages", "more like this", or wants to discover content related to a known URL or concept. Works best after a `crawl` or several `fetch` calls have warmed the local cache. Emits `cold_start` when local signals are weak.

Quality

90%

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 well-structured, highly actionable tool-usage skill: copy-paste invocations, a complete parameter reference, explicit modes, and edge-case handling via cold_start. The only trim opportunities are the triple-stated cache-first advice and a couple of overlong parameter descriptions.

DimensionReasoningScore

Conciseness

Overall efficient — typed parameter table with 'When to use' column, no teaching of known concepts — but the cache-first advice is repeated three times (the 'Build the Cache First' section, its two-step workflow, and the fresh-install anti-pattern), and the `threshold` and step-5 ranking_debug descriptions run long. Not 5: those redundancies could be trimmed; not 3: padding is minor, not a pattern.

4 / 5

Actionability

The Quick Reference gives four copy-paste JSON invocations covering the common cases (URL, concept, domain scoping, cache-only), backed by a full parameter table with types, defaults, and caps, a named env var, and enumerated modes — fully executable guidance. Not 4: there is no missing key detail for the common cases.

5 / 5

Workflow Clarity

A clear 5-step internal sequence, a concrete two-step cache-warming workflow, and an explicit weak-signal feedback loop (cold_start → 'Pass it verbatim to the user') are present, but no checkpoint covers empty or failed results or what to do after a cold start beyond relaying it. Not 5: minor validation gaps remain; not 3: the sequence and the one checkpoint that matters most are explicit.

4 / 5

Progressive Disclosure

No bundle files exist and none are needed: the body is a self-contained, well-sectioned overview whose only links are clearly signaled one-level-deep pointers to sibling skills (wigolo-crawl, wigolo-search) in 'See Also'. The parameter table is required on every invocation, so inlining it is appropriate. Not 4: there is no content misplaced or buried, and navigation is trivial.

5 / 5

Total

18

/

20

Passed

Description

91%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: third-person, concrete about the fusion mechanism, with an explicit 'Use when' clause carrying several natural trigger phrases. The only weaknesses are a single user-facing capability framed through its mechanism, and slight overlap with sibling discovery skills in the same toolchain.

DimensionReasoningScore

Specificity

Concrete mechanism-level capabilities are listed ("fuses embeddings + keyword search + live web search via 3-way Reciprocal Rank Fusion", "Emits cold_start when local signals are weak"), but the user-facing action set is essentially one capability (similarity discovery) with its outputs only implied, so it falls just short of comprehensive coverage.

4 / 5

Completeness

Explicitly answers both what ("Hybrid semantic discovery — fuses embeddings + keyword search + live web search via 3-way Reciprocal Rank Fusion") and when ("Use when the user has a good source and wants more like it...") with concrete trigger phrases, exactly matching the top anchor.

5 / 5

Trigger Term Quality

Multiple natural synonyms users would actually say are present — "find similar", "related pages", "more like this", plus "discover content related to a known URL or concept" — giving comprehensive natural-term coverage for this domain. Not 4: no common variation of the request is missing.

5 / 5

Distinctiveness Conflict Risk

The find-similar niche has distinctive triggers, but "wants more like it" and "discover content" sit adjacent to the sibling search/crawl skills named in the description (crawl, fetch, web search), leaving minor overlap risk. Not 5: the closely related search skill shares the general content-discovery space; not 3: the triggers are far more distinctive than a generic domain statement.

4 / 5

Total

18

/

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

relative_links

Relative link issues: 2 suspicious

Warning

Total

15

/

16

Passed

Repository

KnockOutEZ/wigolo

Path

skills/wigolo-find-similar/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.