CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

wiki-retrieve

Build and query a vault-local contextual BM25 retrieval index with optional multilingual Nomic cosine reranking; use for retrieve, hybrid retrieval, BM25, rerank, contextual retrieval, chunk search, vault search, semantic search, find relevant passages, or retrieval diagnostics. Derived caches stay under .vault-meta, remote egress requires explicit consent, and unavailable reranking falls back deterministically.

75

Quality

94%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 content is a highly actionable, well-validated operational guide: executable commands at every step, explicit failure and fallback behavior, and strong safety boundaries. Its main weakness is density — policy enumerations that belong in the referenced docs are inlined in SKILL.md, slightly bloating the overview.

Suggestions

Replace inline failure-mode enumerations (e.g., "A missing local Ollama service, malformed HTTP reply, missing selected model, unusable vector, or any candidate embedding failure falls back...") with the general rule plus one example, leaving the exhaustive list in docs/prefix-providers.md.

Compress the Contextual-prefix privacy section to the consent requirement plus a pointer, since the linked doc already holds "the exact policy, cloud model selection and verification limits".

Move the untagged-model/:latest alias-matching and 512-token truncation details into the referenced docs, keeping a single operational line in the Query section.

DimensionReasoningScore

Conciseness

The body is dense and product-specific throughout — it explains nothing Claude already knows — but several passages enumerate every failure mode and policy nuance inline where a general rule plus the already-cited doc would do: "A missing local Ollama service, malformed HTTP reply, missing selected model, unusable vector, or any candidate embedding failure falls back...", the incremental-prefixing paragraph, and the untagged-model ":latest" alias rules. This fits anchor 4 (efficient with minor over-explanation that could be trimmed) better than 5, since not every token earns its place.

4 / 5

Actionability

Every operational section gives copy-paste-ready bash: product-root resolution with `test -f` verification, provision commands (`--peek` preview, prefix, build, smoke-test retrieve), read-only query, diagnostics (`stats`, `query`, `--peek`), and the bench invocation. Only `$VAULT`/`$QUERY` placeholders remain, which is standard and expected; common cases are covered.

5 / 5

Workflow Clarity

A clear sequence runs preview → prefix → build index → smoke-test retrieve → query, with explicit validation checkpoints (`test -f`, `--peek`, `--explain`, hash-match gates), an explicit error-recovery loop (exit 10 with a stable rebuild command; deterministic fallback to BM25 order), integrity rules, and a final checklist section. The destructive/batch cap of 3 does not apply: cache writes carry hash validation, fail closed under the vault-wide lock, and never touch canonical notes.

5 / 5

Progressive Disclosure

Sections are clear and the two references ([prefix providers](../../docs/prefix-providers.md), [offline retrieval evaluation](../../docs/retrieval-evaluation.md)) are well-signaled and one level deep. However, the bundle contains only SKILL.md, and the body carries substantial policy detail inline (privacy/egress rules, model selection, tag aliasing, truncation limits) beyond a lean overview even though the linked doc is cited for "the exact policy" — a minor organization gap that fits anchor 4 rather than 5.

4 / 5

Total

18

/

20

Passed

Description

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

The description is exemplary: concrete capabilities, an explicit "use for" trigger clause with ten relevant keywords spanning natural and technical phrasings, and a tightly pinned vault-retrieval niche. The appended constraint sentence (caches, egress consent, fallback) adds scope clarity without vague padding.

DimensionReasoningScore

Specificity

"Build and query a vault-local contextual BM25 retrieval index with optional multilingual Nomic cosine reranking" plus "retrieval diagnostics" lists multiple concrete actions (build, query, rerank, diagnose) covering the skill's whole surface. It exceeds the 4 anchor because there are no minor coverage gaps — build, query, rerank, and diagnostics span the skill's complete capability set.

5 / 5

Completeness

It explicitly answers "what" ("Build and query a vault-local contextual BM25 retrieval index with optional multilingual Nomic cosine reranking") and "when" ("use for ... or retrieval diagnostics") with concrete trigger phrases. The cap of 3 for a missing "Use when" clause does not apply; this matches the anchor-5 example pattern of capability statement plus explicit trigger list.

5 / 5

Trigger Term Quality

The "use for retrieve, hybrid retrieval, BM25, rerank, contextual retrieval, chunk search, vault search, semantic search, find relevant passages, or retrieval diagnostics" clause gives comprehensive coverage mixing natural user phrases ("vault search", "find relevant passages", "semantic search", "chunk search") with technical synonyms ("BM25", "contextual retrieval", "hybrid retrieval"). It is not score 4 because no common variation for this domain is obviously missing; file extensions do not apply to a vault-retrieval niche.

5 / 5

Distinctiveness Conflict Risk

"vault-local contextual BM25 retrieval index" pins a clear niche with retrieval-specific triggers, minimal conflict with generic skills. The single bare term "retrieve" is slightly generic, but anchored to the vault-retrieval context it does not create realistic overlap; it fits the clear-niche anchor better than the 4 anchor's "minor overlap risk with closely related skills".

5 / 5

Total

20

/

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

AgriciDaniel/claude-obsidian

Path

skills/wiki-retrieve/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.