Bitterbot-AI/route-by-query-shape
skills/route-by-query-shape/SKILL.md
When the agent calls memory_search with a relationship-shaped query ("who did I talk to about X"), redirect to the knowledge_graph backend where it will actually find the answer.
$ install --global
skillsauthnpx skillsauth add Bitterbot-AI/bitterbot-desktop route-by-query-shapeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 23, 2026, 2:32 AM74.8s1 file scanned
SKILL.md
- name:
- route-by-query-shape
- description:
- When the agent calls memory_search with a relationship-shaped query ("who did I talk to about X"), redirect to the knowledge_graph backend where it will actually find the answer.
- tier:
- executable
- always:
- false
- - id:
- route-by-query-shape:relationship
- builtin:
- true
- activates_on:
- memory_search with relationship-shaped query
- intervention:
- modify (route to knowledge_graph backend)
route-by-query-shape
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.
Related Skills
Bitterbot-AI/recall-before-claim
testing
VerifiedTrustedCommunity
Forces a memory_search before the agent sends a message containing a factual assertion that has not yet been grounded this turn. Closes the citation-rate gap from ~40% to ~90%+.
1,881SKILL.mdUpdated May 23, 2026
Bitterbot-AI/protocol-quiet-in-groups
business
VerifiedTrustedCommunity
Enforces PROTOCOLS.md "stay quiet in group chats" deterministically. Blocks outbound messages in Discord/Telegram/Slack/etc group channels when the bot was not @mentioned and recently spoke.
1,881SKILL.mdUpdated May 23, 2026
Bitterbot-AI/calibrate-claim-confidence
development
VerifiedTrustedCommunity
When the agent's epistemic state (GCCRF) indicates low empowerment and falling certainty, hedges out confident absolutes ("definitely", "always", "100%") in outgoing messages.
1,881SKILL.mdUpdated May 23, 2026
Bitterbot-AI/notte
tools
VerifiedTrustedCommunity
Deploy browser automations as scheduled, API-callable serverless Functions — plus stealth sessions, vault-backed login, captcha solving, and natural-language agent runs via the Notte CLI. Turns any browser flow into a deterministic Bitterbot-callable endpoint, ideal for crystallized skills + dream-engine cron schedules.
1,369SKILL.mdUpdated May 6, 2026