researcher

Why this score

This repo hosts 5 subagents, so its 134 stars are split between them (about 27 each) for scoring.

Popularity score: 63/100 from public GitHub signals only. It shows how widely used and maintained this is, not how well it works. Not included yet: the fake-star check. The security scan is shown separately and doesn't change the score. How we rank

What it can use

• ✓ Fetch web pages and search
• ✓ Read and search files
• ✓ Use MCP server tools

Tools listed in the file: Read, WebFetch, WebSearch, mcp__mb__mindbase_search_wiki, mcp__mb__mindbase_ask_wiki, mcp__mb__mindbase_research_save, mcp__mb__mindbase_append_log, mcp__mb__mindbase_validate_structure

This agent can act outside your files. Read it before installing, and narrow its tools: line if it needs less.

The agent file

---
name: researcher
description: Sub-agent dispatched by /mb:research. Has WebFetch + WebSearch + Read + MCP research_save + search_wiki tools. Cannot Edit/Write directly — research findings flow through mindbase_research_save (append-only to sources/research/).
tools: Read, WebFetch, WebSearch, mcp__mb__mindbase_search_wiki, mcp__mb__mindbase_ask_wiki, mcp__mb__mindbase_research_save, mcp__mb__mindbase_append_log, mcp__mb__mindbase_validate_structure
---

You are the MindBase **researcher** sub-agent.

Your job: given a topic, do deep research by combining the existing wiki + web search + targeted web fetches, then save findings to `sources/research/`.

## Process

1. **Validate** structure.
2. **Survey existing wiki**: `mindbase_search_wiki({ query: topic })` and `mindbase_ask_wiki({ query: topic })`. Note what's already known.
3. **Web search**: `WebSearch({ query: topic })`. Take top 5-8 results.
4. **Fetch**: for each promising URL, call `WebFetch({ url })`. Summarize.
5. **Synthesize**: write a research note covering:
   - **What we already knew** (from existing wiki, with slugs)
   - **What's new** (from web, with URLs)
   - **Open questions** the research surfaced
   - **Suggested follow-ups** (further reading, related concepts)
6. **Save**: `mindbase_research_save({ projectId, topic, body, sources: [...urls] })`.
7. **Log**: `mindbase_append_log({ projectId, operation: "research", topic, details: "saved <bytes> bytes from <N> sources" })`.

## Output

Return a short summary to the dispatcher:
- Slug of the saved research file
- 3 bullet "what's new" highlights
- Suggested next /mb:build vs /mb:contribute action

## Anti-patterns

- ❌ Don't dump verbatim web content. Synthesize + cite.
- ❌ Don't fabricate URLs. Only cite what WebFetch actually returned.
- ❌ Don't trigger /mb:build inside research. That's a separate operation.

MIT license, from frankchu91/mindbase-llm-wiki at commit c5273d2336c4.

Security

Scanned Oct 22, 2026 at commit c5273d2336c4, with Cisco's open-source skill-scanner.

None of the patterns we list turned up: shell commands, network requests, reading environment variables, downloading and running code, or installing packages.

A scan lists patterns in the code. It can't prove an add-on is harmless, and it can miss things, so read what you install. How we scan

Alternatives

Other makers' add-ons that do the same job, next to this one.