dbs-knowledge turns an ordinary folder into a knowledge base an agent can use without a database or vector store. It audits the folder read-only, then writes a navigation file called SOURCE_OF_TRUTH.md that says what to look for, where it lives and which version wins, and adds a short rule to AGENTS.md so the agent reads it first.
After setup it handles four jobs in everyday language: build, file new material, answer questions with the source files named, and check the folder for dead paths, version conflicts and clutter. It can also shrink an oversized navigation file after backing it up.
What You Get
- A SOURCE_OF_TRUTH.md navigation file with quick-find table, folder roles and version rules
- An agent rule block in AGENTS.md telling the agent to consult the navigation first
- Answers that cite the original file paths and note how current they are
- Suggested paths for new material, with duplicate names kept apart
- A prioritized health report: act now, act soon, leave as is
- A governance pass that merges, sinks and removes entries from a bloated index, with a backup and before and after counts
Common Use Cases
- Making a folder of course notes, contracts or client files searchable by an agent
- Dropping a new file in and having it placed with its source and version relationship recorded
- Finding out which of several files labelled latest is the real one
What Makes It Unique
It works with ordinary files on disk and asks you to install no database, embedding service or third-party upload. The navigation points the way and the agent still reads the original files before answering. It keeps your folder structure, never rewrites source documents, skips secrets and sensitive folders, and asks before any batch change. It also covers index governance, with rules for what to keep, merge and push down into local README files, so the navigation file does not grow without limit.
Under The Hood
It is a prose-only skill with no scripts. The agent reads the SKILL.md and works directly on your folder: it lists directories and reads files you point it at, writes or updates SOURCE_OF_TRUTH.md, adds a short section to AGENTS.md, and creates local README.md files and a backup copy of the old navigation when trimming. It may create a to-sort folder for new bases. It skips .git, dependency folders, env files, keys and other sensitive items, and does not call web services or run commands.