Problem
skills/openkb/SKILL.md currently tells external agents (GitHub Copilot, Claude Code,
Cursor, etc.) to fall back to grep -r for keyword search and to read wiki/index.md in
full for taxonomy/document discovery. Neither is ideal at scale: grep has no
relevance ranking (a document that happens to repeat a generic word often can outrank one
that's actually about the topic), and reading the full index.md costs an increasing
number of tokens as the KB grows, with no guarantee the agent's attention lands on the
right one-liner (see discussion in the referenced chat thread for concrete before/after
examples).
Since #260/#261 (CLI) and #262/#263 (MCP server), the exact same taxonomy-browsing and
tiered-search capability the internal openkb query/openkb chat agent uses is now also
reachable from outside the OpenKB process — but the skill doesn't mention either yet.
Vorschlag
Update skills/openkb/SKILL.md to prefer, in order:
- The MCP server (
openkb-mcp) if the calling agent has MCP tool access — list_taxonomy
then scope-restricted search_wiki, mirroring the internal agent's own search strategy.
- The CLI (
openkb list-taxonomy/openkb search) as a fallback when no MCP client is
configured, still both cheaper and more precise than raw grep.
- Direct
grep/file reads only as a last-resort fallback when neither is available.
No behavior change to the underlying tools/CLI/MCP server themselves — this issue is
skill-documentation-only.
This issue was drafted with the assistance of an AI assistant.
Problem
skills/openkb/SKILL.mdcurrently tells external agents (GitHub Copilot, Claude Code,Cursor, etc.) to fall back to
grep -rfor keyword search and to readwiki/index.mdinfull for taxonomy/document discovery. Neither is ideal at scale:
grephas norelevance ranking (a document that happens to repeat a generic word often can outrank one
that's actually about the topic), and reading the full
index.mdcosts an increasingnumber of tokens as the KB grows, with no guarantee the agent's attention lands on the
right one-liner (see discussion in the referenced chat thread for concrete before/after
examples).
Since #260/#261 (CLI) and #262/#263 (MCP server), the exact same taxonomy-browsing and
tiered-search capability the internal
openkb query/openkb chatagent uses is now alsoreachable from outside the OpenKB process — but the skill doesn't mention either yet.
Vorschlag
Update
skills/openkb/SKILL.mdto prefer, in order:openkb-mcp) if the calling agent has MCP tool access —list_taxonomythen scope-restricted
search_wiki, mirroring the internal agent's own search strategy.openkb list-taxonomy/openkb search) as a fallback when no MCP client isconfigured, still both cheaper and more precise than raw
grep.grep/file reads only as a last-resort fallback when neither is available.No behavior change to the underlying tools/CLI/MCP server themselves — this issue is
skill-documentation-only.
This issue was drafted with the assistance of an AI assistant.