CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

vault-search

Search persistent memory for relevant context — including architectural decisions, resolved bugs, and implementation patterns — when the user asks about past decisions, when debugging a recurring issue, when uncertain whether something was already decided, or before re-implementing something that may have been done before. Use when the user says "do you remember…", "what did we decide about…", or "have we solved this before".

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

73%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 highly actionable — exact commands, flags, exit semantics, examples, and output format — with a clear empty-result feedback loop. Its main weakness is redundancy: three core rules (search first, never fabricate, use noun phrases) are each restated across Mindset, Never, a duplicate second Mindset, and Anti-Patterns sections, inflating token cost without adding information.

Suggestions

Delete the duplicate '## Mindset' section (lines 76-78) — it restates the opening Mindset and Never rules verbatim in spirit.

Merge '## Never' and '## Anti-Patterns' into a single section; both cover the same three rules (search before implementing, never fabricate results, never query with full sentences), so one canonical statement suffices.

Deduplicate '## Query construction' against references/query-tips.md — move the noun-phrase and broadening detail fully into the reference and keep only a one-line pointer in the body, so the split is clean rather than overlapping.

DimensionReasoningScore

Conciseness

The body repeats each core rule two to three times: a literal duplicate '## Mindset' section appears at both the top and bottom, the '## Never' section restates Mindset and Query construction rules, and '## Anti-Patterns' restates 'Never' and 'Handling no results' almost verbatim. This is 'noticeably verbose; several unnecessary… padded sections' (anchor 2) — not 3, because roughly a third of the sections are pure restatement rather than isolated tightening opportunities.

2 / 5

Actionability

Fully executable, copy-paste-ready guidance: exact CLI syntax with flags ('vault-cli search "<query>" [--top-k <n>] [--project <id>]'), explicit exit behavior ('Exits 1 with "No results."'), four concrete example commands covering plain, project-scoped, top-k, and error-message queries, plus a sample output format. Matches anchor 5: examples cover the common cases.

5 / 5

Workflow Clarity

The workflow is clearly sequenced with an explicit feedback loop: construct a noun-phrase query → run the search → on empty, 'Retry with a broader synonym query' → if still empty, report honestly and 'Never invent or guess at a prior decision'. The exit-1/'No results.' signal serves as the validation checkpoint, matching anchor 5's 'feedback loops for error recovery'; this is a non-destructive single-command skill so no validation cap applies.

5 / 5

Progressive Disclosure

Good structure with a well-signaled, one-level-deep reference ('[Vault Search: Query Tips](references/query-tips.md)' — a real file) and clear section headers. Not 5: the duplicate '## Mindset' section and the overlap between the body's 'Query construction' section and the reference file's content ('Use concrete nouns from the task, not the literal user phrasing' appears in both) are minor organization gaps — anchor 4's 'most content is appropriately placed' with 'minor organization gaps'.

4 / 5

Total

16

/

20

Passed

Description

86%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 that clearly and explicitly states what the skill does and when to use it, with excellent natural trigger phrases drawn from actual user wording. Its only gaps are a single-action capability list and somewhat broad proactive triggers that slightly raise conflict risk.

DimensionReasoningScore

Specificity

The description names the domain ('persistent memory') and one concrete action ('Search persistent memory for relevant context'), with specific search targets ('architectural decisions, resolved bugs, and implementation patterns'), but only a single action verb is ever listed. It matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') rather than 4, which requires several distinct actions.

3 / 5

Completeness

Explicitly answers both: 'what' ('Search persistent memory for relevant context — including architectural decisions, resolved bugs, and implementation patterns') and 'when' via multiple when-clauses plus an explicit 'Use when the user says…' with concrete trigger phrases. This is a direct match for the anchor-5 example pattern.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage including direct quotes of user phrasing ('do you remember…', 'what did we decide about…', 'have we solved this before') plus paraphrased triggers ('past decisions', 'recurring issue', 're-implementing something that may have been done before'). These synonyms span the recall/past-context domain; not level 4 because no common variation of this intent is conspicuously absent.

5 / 5

Distinctiveness Conflict Risk

Clear niche (persistent-memory recall) with distinct quoted triggers, but the proactive triggers ('when uncertain whether something was already decided, or before re-implementing something that may have been done before') are broad and could fire on many tasks, creating minor overlap with other pre-task skills. Mostly distinct with minor overlap risk — anchor 4, not 5.

4 / 5

Total

17

/

20

Passed

Validation

100%

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

pantheon-org/tekhne

Path

skills/agentic-harness/vault-search/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.