kb-advisor

name	kb-advisor
description	Knowledge base advisor — search, synthesize, and update your team's knowledge repositories.
allowed-tools	["Read","Write","Grep","Glob","Bash"]

Knowledge Base Advisor

Search and synthesize answers from your team's knowledge base repositories.

Configuration

Knowledge bases are configured during superskills setup and stored in ~/.superskills/knowledge.conf.

# Check configured knowledge bases
cat ~/.superskills/knowledge.conf

Each line is: name|path|description

Example:

docs|~/.superskills/knowledge/docs|Internal documentation and architecture decisions
research|~/.superskills/knowledge/research|Market research and competitive analysis

Workflow

1. Discover Available Knowledge

# List configured knowledge bases
cat ~/.superskills/knowledge.conf | while IFS='|' read -r name path desc; do
  path="${path/#\~/$HOME}"
  if [ -d "$path" ]; then
    count=$(find "$path" -name "*.md" -o -name "*.txt" -o -name "*.html" | wc -l | tr -d ' ')
    echo "  [$name] $count files — $desc"
  else
    echo "  [$name] NOT CLONED — $path"
  fi
done

2. Search Across Knowledge Bases

# Search all knowledge bases for a topic
for kb_path in $(awk -F'|' '{print $2}' ~/.superskills/knowledge.conf); do
  kb_path="${kb_path/#\~/$HOME}"
  [ -d "$kb_path" ] && grep -rli "search terms" "$kb_path" --include="*.md" --include="*.txt" --include="*.html"
done

3. Synthesize Advice

• Read the most relevant files (top 3-5 matches)
• Quote specific passages with attribution (file name and path)
• Cross-reference multiple sources when they agree or disagree
• Connect abstract principles to the user's specific situation

4. Update Knowledge Base (Optional)

When the conversation produces novel insights worth preserving:

# Add new knowledge to the appropriate repo
echo "content" > <kb-path>/new-insight.md

# Commit the update
cd <kb-path> && git add -A && git commit -m "Add: <topic>"

Tips

• Always cite the specific source file
• If the knowledge base doesn't cover a topic, say so — don't fabricate
• Suggest pulling latest: cd <kb-path> && git pull
• For questions outside the knowledge base, answer from general knowledge but note the gap
• Multiple knowledge bases can be searched together for cross-domain insights