Kb search

Skill vakovalskii/ontoship/skills/kb-search

Search a project's markdown knowledge base (docs/, README files, *.md) via the GitMark CLI — FTS5 ranking (bm25) plus trigram/fuzzy matching — instead of grepping across files. Use when you need to find where something is documented, "where do the docs say X", before reading files at random, or to generate an HTML overview/graph of the knowledge base. Handles substrings, typos, and non-Latin scripts.From its SKILL.md

Install

npx -y skills add vakovalskii/ontoship --skill kb-search

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

SKILL.md

2.4 KB, as published. Nobody here has run it

GitMark — knowledge-base search

This plugin treats the repo's markdown as a md + README(index) + git knowledge base. Markdown is the source of truth; the search index and HTML map are derived and regenerated from md (.gitmark/ is gitignored). The CLI is pure Python stdlib.

Script: ${CLAUDE_PLUGIN_ROOT}/skills/kb-search/gitmark.py (when run as a project-local copy, it's .claude/skills/kb-search/gitmark.py).

When to use

You need to find where something is documented → gitmark search, not a grep/rg fan-out. Results are file:line · heading · snippet.
"How does X work here", "where are the docs for Y".
Before reading files at random — locate the exact spots first.
Want an overview/graph of the KB → gitmark map.

Commands

G="python3 ${CLAUDE_PLUGIN_ROOT:-.claude/plugins/gitmark}/skills/kb-search/gitmark.py"

$G index                 # (re)build .gitmark/index.db  (fast)
$G search "<query>"      # bm25 + trigram(substring) + fuzzy(3-gram); -k N, --json
$G map -o docs-map.html  # self-contained HTML: tree + rendered md + radial graph
$G serve -p 8799         # local http server to view the map
$G stat                  # files/chunks/links/index state
$G lint [paths…]         # ontology check (frontmatter/links/README/broken links)
$G version

Workflow

If the index may be stale (docs changed) → gitmark index.
gitmark search "<terms>" — typos and morphology are tolerated (trigram/fuzzy). [bm25] = exact term, [trigram] = substring, [fuzzy] = n-gram (typos/forms).
Open the returned file:line and read the exact place.
--json for machine-readable results.

Principles

Markdown is the source of truth. Edit knowledge in .md, never the index.
Don't commit .gitmark/ (it's in .gitignore).
Index is a cache — if results look stale, rebuild with gitmark index --force.
How to maintain the KB (ontology, file placement) — see the kb-curate skill.