route-by-query-shape

SkillAI & models

This skill helps your AI answer relationship questions better, like who you talked to about a certain topic. When your AI searches its memory with a question shaped like that, the search gets redirected to the knowledge graph, where the answer can actually be found.

Available today. Use it from your connected AI after setup.

After adding it, ask your AI a question like who did I talk to about a topic and the answer will come from the knowledge graph instead of a plain memory search.

Then ask your AI: use the route-by-query-shape skill

What your AI can do with it

  • Recognize memory searches shaped like relationship questions, such as who you talked to about a topic
  • Redirect those searches to the knowledge graph
  • Find answers in the knowledge graph that a regular memory search would miss
  • Give better answers to who-did-I-talk-to questions

What this skill tells your AI

The instructions your AI receives, as published by bitterbot-ai/bitterbot-desktop in skills/route-by-query-shape/SKILL.md and read by ahel’s review.

When you ask Bitterbot a relationship question — "who did I talk to about Q4?", "who worked with me on Foo?" — the vector-based memory_search often misses because the answer lives in entity relationships, not in chunk text. The graph backend gets these right.

This interceptor watches memory_search calls, detects relationship-shaped queries, extracts the salient entity, and re-routes the call to the graph backend before it executes.

What you'll see

For relationship questions, the agent will hit the knowledge graph rather than searching through unstructured text. Expect noticeably better hit rates on "who did X with Y" style questions.

Implementation

Built-in interceptor route-by-query-shape:relationship lives in src/agents/skills/builtin-interceptors/route-by-query-shape.ts. Fires up to 12 times per session.

Signals

GitHub stars
2k
Forks
417
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
route-by-query-shape
Source
github.com/bitterbot-ai/bitterbot-desktop