CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

wiki-query

Answer an explicitly vault-scoped question from an Obsidian wiki without changing it. Use when the user selects the vault as the evidence source: query the wiki, query quick, query deep, explain from the wiki, summarize the vault, find in wiki, search the wiki, or based on the wiki. Do not route ordinary general-knowledge questions here.

67

Quality

84%

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

81%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, read-only query workflow with concrete CLI commands, explicit verification gates, tiered read budgets, and thorough provenance rules. The main weaknesses are a placeholder product-root resolution that is not copy-paste executable, a redundant closing Checkpoint section, and external references that do not resolve within the bundle as shipped.

Suggestions

Replace the placeholder "PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian" with a concrete derivation from the skill's own location (e.g., using dirname on the SKILL.md path), so the resolution block is executable as written.

Drop or merge the Checkpoint section into Assess evidence / Answer, since it restates rules already stated there, trimming token cost without losing guidance.

Ship the referenced files (provenance.md, wiki-retrieve, wiki-cli) inside the skill bundle or point the links to files that resolve, so the one-level-deep references are actually navigable.

DimensionReasoningScore

Conciseness

The body is dense with operational rules (depth tiers with KiB budgets, exact ledger paths, per-claim-state rules) and teaches nothing Claude already knows, so it is well past anchor 3. Not 5 because the Checkpoint section ("Observe what the vault actually contains, think about contradictory or missing evidence, verify every material citation...") largely restates the Retrieve/Assess/Answer sections, and the untrusted-evidence paragraph enumerates example payloads that could be trimmed.

4 / 5

Actionability

Concrete, executable commands are given with flags ("python3 \"$CORE\" contracts --vault \"$VAULT\" --verify --capability wiki-retrieve", "python3 \"$RETRIEVE\" --vault \"$VAULT\" \"$QUERY\" --top 5 --no-rerank --explain") plus specific ledger paths and a citation format ("[[Page#Heading]]"). Not 5 because the PRODUCT_ROOT block is a non-executable placeholder ("PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian") — the skill says to resolve it from its own location but never shows how — and $VAULT/$QUERY resolution is left implicit.

4 / 5

Workflow Clarity

The Retrieve section is a numbered sequence with an explicit verification gate (contracts --verify before using the index), a path-containment check ("Read candidate pages only after confirming each reported path stays inside $VAULT/wiki/"), branch handling for Quick vs Standard/Deep, and a defined error-recovery fallback ("If retrieval is unavailable, degraded, empty, or stale, fall back to wiki/index.md... Say which fallback was used"). This matches the anchor-5 pattern of explicit validation steps with feedback loops; a 4 would require missing checkpoints, which are present throughout.

5 / 5

Progressive Disclosure

The body is well-sectioned and its three outgoing links are one level deep with stated purpose ("[wiki-retrieve](../wiki-retrieve/SKILL.md) for cache and rerank behavior", "[wiki-cli](../wiki-cli/SKILL.md) for read/search transport selection", the provenance rules reference). Not 5 because none of the referenced targets exist in the shipped bundle — there are no references/, scripts/, or assets/ directories and the ../wiki, ../wiki-retrieve, and ../wiki-cli paths do not resolve — so the references cannot actually be navigated from this skill as packaged.

4 / 5

Total

17

/

20

Passed

Description

82%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 tight, well-bounded description that clearly states what the skill does, when to invoke it with concrete natural-language triggers, and what to exclude. The only notable gap is capability breadth: it names the single composite action rather than the distinct operations the skill performs (depth-tiered retrieval, provenance-graded evidence, wikilink citation).

DimensionReasoningScore

Specificity

"Answer an explicitly vault-scoped question from an Obsidian wiki without changing it" names the domain and one clear concrete action with a read-only constraint, but does not enumerate the skill's several capabilities (indexed retrieval, claim-ledger provenance assessment, wikilink citation). Not 4 because anchor 4 requires several distinct listed actions; not 2 because the action stated is specific, not generic.

3 / 5

Completeness

Both parts are explicit: the what ("Answer an explicitly vault-scoped question from an Obsidian wiki without changing it") and the when ("Use when the user selects the vault as the evidence source: ..." with concrete trigger phrases), plus a negative boundary ("Do not route ordinary general-knowledge questions here"). This matches the top anchor exactly; a lower score would require a weaker or implicit 'when' clause, which is not the case.

5 / 5

Trigger Term Quality

The when-clause lists natural user phrasings — "query the wiki, query quick, query deep, explain from the wiki, summarize the vault, find in wiki, search the wiki, or based on the wiki" — giving good keyword coverage. Not 5 because common synonyms like "my notes", "per my vault", or "according to the vault" are absent; not 3 because coverage clearly exceeds a single generic keyword.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche — read-only, vault-scoped Q&A from an Obsidian wiki — with distinct trigger phrasing and an explicit exclusion ("Do not route ordinary general-knowledge questions here") that minimizes mis-triggering against general search or note-mutation skills. Fits the anchor-5 example pattern of a distinct niche with dedicated triggers.

5 / 5

Total

17

/

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: 3 suspicious

Warning

Total

15

/

16

Passed

Repository

AgriciDaniel/claude-obsidian

Path

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