mcpField
K
kb-advisor

kb-advisor

github.com/ariadossProductivity1260 installsUpdated today
Repository

About kb-advisor

kb-advisor is a knowledge-base search and synthesis skill for teams. It searches configured repositories, cites source files, and can preserve new insights in a repository.

Key features

  1. 01Search configured knowledge bases
  2. 02Synthesize answers across sources
  3. 03Cite passages with file paths
  4. 04Optionally add insights to a repository

Use cases

  1. 01Find answers in internal documentation
  2. 02Compare information across repositories
  3. 03Preserve useful conversation insights

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ariadoss/superskills --skill kb-advisor

After installing, type/kb-advisorin Claude Code to confirm it loaded.

Details

From the project README

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

Comments

Markdown supported