vaultspec-rag-discovery SKILL.md skillA

vaultspec-rag-discovery from nevenincs/vaultspec-core is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add nevenincs/vaultspec-core/vaultspec-rag-discovery@git:20260717.822511b

Pins git:20260717.822511b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
nevenincs/vaultspec-core
Path
.vaultspec/skills/vaultspec-rag-discovery/SKILL.md
Versions recorded
1
Latest version
git:20260717.822511b, committed Jul 17, 2026
Size
7,402 bytes
Repository stars
2
License
MIT

Semantic codebase and architecture-decision discovery with vaultspec-rag - find code and the ADRs that govern it by meaning, then narrow with advanced filters and noise controls. Use to locate where or how something is done, or the decision behind it, instead of guessing identifiers or sweeping with keyword/grep search.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Semantic discovery with vaultspec-rag

vaultspec-rag finds things by MEANING. When you need to locate where or how something is done
and do not already know the exact symbol, lead with a semantic search rather than a keyword
sweep: keyword search only finds the words you already guessed, while semantic search finds the
concept even when the code names it differently. The project's own discovery benchmarking is
the basis for leading with it - a semantic-led hybrid sweep reaches the right file in about one
call at roughly 1.3-2x less context than a broad grep or glob on a large tree, and recalls the
governing decision with almost no noise.

Treat vaultspec-rag as a discovery instrument and grep as the exact-symbol confirmer: a search
lands you on the right surface, grep pins the precise line. Never conclude "there is no such
site" from a search alone - confirm with grep.

## The method: locate by meaning, read, confirm

1. **Locate by meaning.** Run a semantic search to reach the epicenter file (code) or the
   governing record (a decision). One tight query gets you there.
1. **Read the epicenter whole.** Open the top file (or the nearest existing analogue) in full.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nevenincs/vaultspec-core/vaultspec-rag-discovery@sha256:03268b7bf42a0872

The line at the top of this page pins the label git:20260717.822511b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_oij5gsjhhhmmnsqr.svg)](https://markdownregistry.com/a/art_oij5gsjhhhmmnsqr)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Jul 17, 2026.

versioncommittedcommitsizeaudit
git:20260717.822511b latest2026-07-17 822511b 7,402 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7402 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

nevenincs/vaultspec-core · 2 stars · license MIT · pushed 2026-10-27 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_oij5gsjhhhmmnsqr
GET https://markdownregistry.com/api/v1/resolve?ref=nevenincs/vaultspec-core/vaultspec-rag-discovery
GET https://markdownregistry.com/api/v1/blob/03268b7bf42a0872c7b70a88c6ad68e46ab1ef0f157511e9e6ec457255692148

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from nevenincs/vaultspec-core

vaultspec-adr SKILL.md skill
nevenincs/vaultspec-core · .vaultspec/skills/vaultspec-adr/SKILL.md · Record a costly decision, place it within accepted decision coverage, and reconcile affected ADR wording.
git:20260927.50639bc · audit A · 2 stars
vaultspec-code-research SKILL.md skill
nevenincs/vaultspec-core · .vaultspec/skills/vaultspec-code-research/SKILL.md · Ground a decision or plan in how real code does it. Use when an ADR or plan needs a blueprint from this or another…
git:20260924.afdc9ea · audit A · 2 stars
vaultspec-code-review SKILL.md skill
nevenincs/vaultspec-core · .vaultspec/skills/vaultspec-code-review/SKILL.md · Review completed planned work for safety, intent, and quality using applicable verification evidence. Use at the…
git:20260927.50639bc · audit A · 2 stars
vaultspec-curate SKILL.md skill
nevenincs/vaultspec-core · .vaultspec/skills/vaultspec-curate/SKILL.md · Audit and reconcile existing ADRs, implementation, and supporting records when the user requests vault curation or…
git:20260927.50639bc · audit A · 2 stars
vaultspec-documentation SKILL.md skill
nevenincs/vaultspec-core · .vaultspec/skills/vaultspec-documentation/SKILL.md · Create or substantially rewrite one user-facing README, guide, or feature document. Focused maintenance edits use a…
git:20260908.ce86e08 · audit A · 2 stars
vaultspec-execute SKILL.md skill
nevenincs/vaultspec-core · .vaultspec/skills/vaultspec-execute/SKILL.md · Implement or resume an approved plan with project conventions, proportionate verification, and durable Step checkpoints.
git:20260927.50639bc · audit A · 2 stars
vaultspec-projectmanager SKILL.md skill
nevenincs/vaultspec-core · .vaultspec/skills/vaultspec-projectmanager/SKILL.md · Coordinate multiple active workstreams on explicit user request: epics, project boards, cross-worktree issue triage…
git:20260927.50639bc · audit A · 2 stars
vaultspec-research SKILL.md skill
nevenincs/vaultspec-core · .vaultspec/skills/vaultspec-research/SKILL.md · Ground a decision in evidence before it is made. Use when an ADR is warranted and the options have not been weighed on…
git:20260927.50639bc · audit A · 2 stars
vaultspec-team SKILL.md skill
nevenincs/vaultspec-core · .vaultspec/skills/vaultspec-team/SKILL.md · Supervise several workers over one approved plan. Use when the plan's Parallelization section names containers that may…
git:20260927.50639bc · audit A · 2 stars
vaultspec-write SKILL.md skill
nevenincs/vaultspec-core · .vaultspec/skills/vaultspec-write/SKILL.md · Write a proportionate implementation plan when scope or progress needs durable sequencing, after assessing decision…
git:20260908.ce86e08 · audit A · 2 stars
vaultspec-adr SKILL.md skill
nevenincs/vaultspec-core · src/vaultspec_core/builtins/skills/vaultspec-adr/SKILL.md · Record a costly decision, place it within accepted decision coverage, and reconcile affected ADR wording.
git:20260927.50639bc · audit A · 2 stars
vaultspec-code-research SKILL.md skill
nevenincs/vaultspec-core · src/vaultspec_core/builtins/skills/vaultspec-code-research/SKILL.md · Ground a decision or plan in how real code does it. Use when an ADR or plan needs a blueprint from this or another…
git:20260924.afdc9ea · audit A · 2 stars

Every file in nevenincs/vaultspec-core

Browse by kind, by grade A, or by owner.