OpenParable
Skip to content
← Back to skills

Kb Guide

Documents
kb-guide

Kb Guide is an Agent Skill for documents published in the 0xranx/golembot repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Search, read, create, and update knowledge base entries via MCP-connected KB tools. Use when the user asks to look up documentation, find existing articles, check if docs exist on a topic, create a new KB entry, update an existing document, or when domain questions should be answered from the knowledge base first.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/0xranx/golembot/blob/HEAD/skills/kb-guide/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/kb-guide, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Knowledge Base Integration Guide

When MCP knowledge base servers are configured, you can use their tools to search, read, create, and update knowledge entries.

Common MCP Knowledge Base Tools

MCP KB servers typically expose tools with these patterns:

Search / Query

  • search_documents(query, limit?) -- full-text search across the knowledge base
  • search_notes(query) -- search personal notes or wiki entries
  • query_knowledge(query, filters?) -- filtered search with metadata constraints

Read

  • get_document(id) -- retrieve a document by ID
  • read_page(path) -- read a wiki page by path
  • list_documents(folder?, tag?) -- list documents in a folder or by tag

Create / Update

  • create_document(title, content, metadata?) -- create a new entry
  • update_document(id, content) -- update an existing document
  • create_note(title, body) -- create a quick note

Example Tool Call

When a user asks "do we have docs on deployment?", search the KB first:

Tool: search_documents
Arguments: { "query": "deployment", "limit": 5 }

Present matching results with titles and snippets. If no results are found, offer to create a new entry.

When to Use Knowledge Base

  • Before answering domain questions: Search the KB first -- it may contain authoritative answers
  • When the user asks "do we have docs on...": Search the KB and return results
  • After resolving an issue: Suggest creating a KB entry to capture the solution
  • For onboarding/FAQ questions: Check if there's an existing KB article

Usage Pattern

  1. Identify the user's intent (search, read, write)
  2. Call the appropriate MCP tool by name
  3. If a tool is not available, inform the user that no KB server is configured
  4. Present results clearly -- include titles, snippets, and links when available

Notes

  • MCP server configuration is defined in golem.yaml under the mcp key
  • Available MCP tools depend on which servers are configured -- use tool discovery to check
  • Always prefer searching the KB before generating answers from your own training data