# Kb Advisor

> Knowledge base advisor — search, synthesize, and update your team's knowledge repositories.

- Skill: `bg-szy/kb-advisor` (Agent Skill)
- Install (CLI): `npx skillmds@latest add bg-szy/kb-advisor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bg-szy/kb-advisor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: bg-szy (https://skillmd.com/u/bg-szy)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bg-szy/kb-advisor

---


# 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`.

```bash
# 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

```bash
# 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

```bash
# 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:

```bash
# 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