# Research

> Research a topic across gopher-cli sources, read relevant documents, and save a structured summary to the vault

- Skill: `diegosouzapw/research-4` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add diegosouzapw/research-4`
- Raw SKILL.md: https://api.skillmd.com/api/skills/diegosouzapw/research-4/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: diegosouzapw (https://skillmd.com/u/diegosouzapw)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/diegosouzapw/research-4

---


Research the topic: **$ARGUMENTS**

Follow this workflow using the gopher-cli CLI via Bash tool calls. Output is auto-JSON when piped.

## 1. Discover sources

List available namespaces and browse each root to see what's available:

```bash
gopher-cli browse
gopher-cli browse feed.hackernews/
gopher-cli browse vault/
```

## 2. Search for relevant content

Search across every namespace with keywords from the topic. Cast a wide net — try synonyms and related terms:

```bash
gopher-cli search feed.hackernews/ "topic keywords"
gopher-cli search vault/ "topic keywords"
gopher-cli search docs/ "related term"
```

## 3. Read the most relevant documents

Fetch the top results. Extract key facts, quotes, and insights. Note which source each piece came from:

```bash
gopher-cli fetch feed.hackernews/entry/5
gopher-cli fetch vault/research/related-note.md
```

## 4. Synthesize findings

Produce a structured research note in markdown:

```
# Research: [topic]
Date: [today]

## Summary
[2-3 sentence overview]

## Key Findings
- [finding 1 — with source]
- [finding 2 — with source]
- ...

## Details
[longer analysis organized by theme]

## Sources
- [namespace/path] — [what it contained]
```

## 5. Save to vault

Publish the note to the vault:

```bash
gopher-cli publish vault/research/[slugified-topic].md --content "[markdown content]"
```

Confirm what you saved and where.

