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.

Quality

97%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

100%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 excellent across all dimensions: it is concise and executable with real commands, sequences multi-step operations with explicit validation and recovery loops, and is cleanly sectioned without requiring external references. It exemplifies a well-constructed skill body.

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes Claude's competence — it never explains what BM25 or embeddings are, and every section (pipeline, commands, integrity rules, diagnostics) earns its tokens without padding.	5 / 5
Actionability	Provides fully executable, copy-paste-ready bash with concrete script paths and real flags (--peek, --no-rerank, --explain, --model), covering build, query, rerank, and diagnostic cases.	5 / 5
Workflow Clarity	A clear numbered pipeline plus a preview-then-build provisioning sequence is reinforced by explicit validation/recovery checkpoints — hash matching, lock-fails-closed, and exit 10 with a stable rebuild command — satisfying the validation requirement for batch/index operations.	5 / 5
Progressive Disclosure	No bundle files exist and none are needed; the single-purpose skill is organized into well-signaled sections (Pipeline, Provision locally, Privacy, Query, Integrity rules, Checkpoint) with no inlined material that belongs elsewhere, matching the simple-skill exception.	5 / 5
	Total	20 / 20 Passed

Description

95%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 strong: it states concrete capabilities, provides a rich set of natural trigger terms, explicitly pairs 'what' with a 'use for ...' when clause, and occupies a distinct niche. It is comprehensive and well-targeted, with only minor technical-density in phrasing keeping specificity just below the top anchor.

Dimension	Reasoning	Score
Specificity	Names multiple concrete actions ('Build and query a vault-local contextual BM25 retrieval index', 'optional multilingual Nomic cosine reranking', 'retrieval diagnostics') with implementation specifics, but the phrasing leans technical rather than plain-action, leaving it just shy of the fully comprehensive anchor.	4 / 5
Completeness	Explicitly answers both 'what' (build and query a contextual BM25 index with reranking) and 'when' via the explicit 'use for ...' trigger clause, satisfying the completeness anchor with concrete trigger phrases.	5 / 5
Trigger Term Quality	Comprehensive natural trigger coverage with synonyms — 'retrieve, hybrid retrieval, BM25, rerank, contextual retrieval, chunk search, vault search, semantic search, find relevant passages, or retrieval diagnostics' — matching the full-synonym anchor.	5 / 5
Distinctiveness Conflict Risk	A clearly defined niche (vault-local BM25 + Nomic cosine rerank with explicit egress/fallback semantics) makes it highly distinguishable from other skills with minimal overlap risk.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: AgriciDaniel/claude-obsidian
Path: skills/wiki-retrieve/SKILL.md
Commit: ad67087

Reviewed: 10 days ago

Table of Contents

Discovery Implementation Validation

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.