kb

Upsert conversation insights into a project knowledge base Markdown file.

2|Updated Mar 10, 2026

Search Tags:#documentation #markdown #notes #conversations #knowledge-base #kb #upsert

Ready to run

npx skills add https://github.com/tim-hub/powerball --skill kb-tim-hub

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: kb
Source: https://github.com/tim-hub/powerball/tree/main/personal/skills/kb
Command: npx skills add https://github.com/tim-hub/powerball --skill kb-tim-hub

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ripgrep, and includes scripts (resource) components.

What problem does it solve?

The knowledge base upsert skill helps you maintain a structured repository of insights, decisions, and learnings by upserting key information from conversations into a project's knowledge base.

Core Features & Use Cases

Upsert new insights and decisions into a centralized knowledge base, ensuring important context is never lost.
Update existing topics with fresh findings or revised conclusions, preserving the history of decisions.
Automatically timestamp changes and organize content by topic, making retrieval and auditing straightforward.

Quick Start

Save an important insight to the knowledge base by asking me to "save this to kb" or "kb add" and I will create or update the relevant topic.

Frequently Asked Questions about kb

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

FAQPage Schema

How do I save conversation insights to a markdown knowledge base?▼

To save conversation insights to a markdown knowledge base, use the kb upsert feature to write new findings or update existing topics with timestamps in a structured Markdown file.

How does upserting a knowledge base work for project decisions?▼

Upserting a knowledge base works by reading the project name from your directory and using a shell script to create or update sections in a Markdown file, preserving decisions and critical context with timestamps.

Do I need ripgrep to manage project notes and documentation?▼

Yes, you need ripgrep installed as a dependency to manage project notes and documentation, because the upsert scripts rely on it for searching and updating the structured Markdown knowledge base.

Can I update existing topics in a knowledge base without losing history?▼

Yes, you can update existing topics in a knowledge base without losing history, because the upsert process automatically adds timestamps to revised conclusions and preserves previous decisions within the structured Markdown file.

What is the best way to keep feature development learnings in sync?▼

The best way to keep feature development learnings in sync is to upsert key information by topic into a centralized knowledge base, ensuring critical context and decisions are never lost during planning.

Why is my knowledge base upsert not writing to the correct project file?▼

A knowledge base upsert may not write to the correct project file if the local configuration in ~/.kb/config.json is missing or if the current project name cannot be read from the directory.