document-retrieval

Searches gbrain knowledge base for previously stored documents by keyword and returns summaries.

1|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/tapway/shogun-os --skill document-retrieval-tapway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-retrieval
Source: https://github.com/tapway/shogun-os/tree/main/skills/general/document-retrieval
Command: npx skills add https://github.com/tapway/shogun-os --skill document-retrieval-tapway

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding a previously scanned invoice, quotation, or contract buried in a knowledge base is slow and error-prone. This Skill searches the gbrain knowledge base by keyword and returns concise document summaries with key fields, so users can locate documents without browsing folders manually. ## Core Features & Use Cases - Keyword Search: Queries gbrain via mcp_gbrain_search using vendor names, document numbers, dates, or document types. - Filtered Results: Restricts matches to the references/documents/ path so unrelated brain pages are excluded. - Formatted Summaries: Returns title, summary, and key fields (invoice number, date, total, due date) instead of full OCR text, formatted for Telegram. - Use Case: A user asks "find the invoice from XYZ Sdn Bhd" and receives the invoice number, date, total, and storage path within seconds. ## Quick Start Ask the agent to find the invoice from a specific vendor by name or document number.

Frequently Asked Questions about document-retrieval

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find a stored invoice by vendor name?

Ask the agent to find the invoice using the vendor name, for example "find the invoice from XYZ Sdn Bhd". The skill runs a gbrain search with a query like "document XYZ invoice" and returns matching summaries with key fields.

What search queries work for document retrieval in gbrain?

Queries combine the word "document" with a vendor name, document number, date, or type, such as "document invoice August 2026" or "document contract ABC". Results are filtered to the references/documents/ path and ranked by relevance.

Can this skill store or scan new documents?

No, it only retrieves documents already stored in gbrain. Storing is handled by the document-storage skill, and OCR or interpretation is handled by upstream skills like document-ocr and document-interpretation.

Why does document search return no results?

No results usually means the documents were never stored via document-storage, gbrain is not indexed with the document pages, or the query terms do not match stored content. Try broader keywords or a different vendor spelling.

Does document retrieval return the full document text?

No, it returns only the title, summary, and key fields such as invoice number, date, and total. Full OCR text is intentionally excluded because it is too long for chat interfaces like Telegram.