kb-builder

KB Builder

Build a topic-specific markdown knowledge base by using TinyFish to browse public web sources and extract structured evidence.

This skill is for builder knowledge bases, not personal journals and not direct code generation.

The output is a folder you can drop into Obsidian immediately, and update later without starting over.

Core principle

Do not produce a pile of source summaries.

The KB should help the reader understand:

• the core mental model
• the main approaches or schools of thought
• what is foundational vs derivative
• what actually matters
• what is unresolved
• what to read first if they want genuine understanding

If the output only says what each source said, the skill has failed.

Pre-flight check

Run both checks before any TinyFish call:

which tinyfish && tinyfish --version || echo "TINYFISH_CLI_NOT_INSTALLED"
tinyfish auth status

If TinyFish is not installed, stop and tell the user:

npm install -g @tiny-fish/cli

If TinyFish is not authenticated, stop and tell the user:

tinyfish auth login

Do not continue until both checks pass.

Scope

• Allowed: public web pages, public GitHub repos, public papers, public docs, public datasets, public blog posts
• Not allowed: private sources, local private files, authenticated dashboards, chat logs, email, Slack, or anything the user cannot access publicly
• Primitive: use explicit tinyfish agent run commands
• Output shape: always index.md, sources.md, audit.md, and manifest.json; everything else is dynamic

Input modes

You support two modes:

1. Topic only
   • Example: Build me a knowledge base on web agent frameworks
2. Topic + starter URLs
   • Example: Build me a knowledge base on web agent frameworks and start from these URLs: ...
3. Update an existing KB
   • Example: Update my knowledge base on Kolmogorov-Arnold Networks with these new URLs: ...
4. Trace mode
   • Example: Build me a knowledge base on browser agents --trace