| name | db-read |
| description | Find and read documents from the database matching a query. Searches the index for relevant entries, then reads and synthesizes the content. Use this when the user wants to retrieve stored information. |
Read from Database
Find and retrieve documents matching the user's query.
Use TaskCreate to create a task for each step below, then execute them in order. Mark each task in_progress when starting and completed when done using TaskUpdate.
Step 1: Verify Database
Use the Skill tool to invoke the db-verify skill.
If verification fails, STOP execution and relay the error message to the user.
Step 2: Read Index
Use the Read tool to read database/index.md.
Parse the index to extract the list of documents. Each document entry follows the format:
- [Topic](filename.md) - Description
If the index shows "No documents yet." or has no document entries:
- Report to the user: "The database is empty. No documents have been stored yet."
- STOP execution.
Step 3: Find Relevant Documents
Analyze the user's query and search the index entries for relevant documents.
Match based on:
- Topic name (exact or partial match)
- Description keywords
- Semantic relevance to the query
Create a list of relevant document filenames to read.
If no relevant documents are found:
- Report to the user: "No documents found matching your query. Here's what's in the database:" followed by a list of available topics.
- STOP execution.
Step 4: Read Documents
For each relevant document identified in the previous step:
Use the Read tool to read database/<filename>.md
Collect the content from all relevant documents.
Step 5: Synthesize and Report
Combine the information from all read documents and present a clear, helpful response to the user's query.
- Answer the user's specific question based on the document content
- Be concise and relevant
- If the documents don't fully answer the query, note what information is available and what's missing
