quick-topic-researcher

What this skill does

# Quick Topic Researcher

**5 minutes to topic mastery.** This skill generates a focused research brief you can use immediately before recording a video or writing content.

**Different from `deep-researcher`:** That skill is comprehensive (5+ sources, file-based, 30+ minutes). This skill is FAST (5 questions, parallel search, 5 minutes).

---

## When to Use

| Use Case | This Skill |
|----------|------------|
| Prepping for a YouTube video | Yes |
| Writing a quick tweet thread | Yes |
| Refreshing knowledge on a topic | Yes |
| Before a podcast discussion | Yes |
| Comprehensive literature review | No → Use `deep-researcher` |
| Writing a formal editorial | No → Use `deep-researcher` first |

---

## How It Works

```
TOPIC: "GLP-1 agonists in heart failure"
DOMAIN: "Cardiology"

    │
    ▼
┌─────────────────────────────────────────────────────┐
│ STEP 1: Generate 5 Research Questions               │
│                                                      │
│ 1. Do GLP-1 agonists reduce heart failure           │
│    hospitalization in diabetic patients?            │
│ 2. Is there evidence of direct cardiac benefit?     │
│ 3. What are the key trials showing CV outcomes?     │
│ 4. Are there safety concerns in existing HF?        │
│ 5. What do current guidelines recommend?            │
└─────────────────────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────────────────────┐
│ STEP 2: Parallel Research (5 searches at once)      │
│                                                      │
│ [PubMed Q1] [PubMed Q2] [PubMed Q3] [Perplexity Q4] │
│ [Perplexity Q5]                                      │
│                                                      │
│ ~30 seconds total                                    │
└─────────────────────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────────────────────┐
│ STEP 3: McKinsey-Style Brief                         │
│                                                      │
│ EXECUTIVE SUMMARY                                    │
│ • Key finding with strongest PMID                   │
│                                                      │
│ ANALYSIS                                             │
│ • Theme 1: Trial evidence (PMIDs)                   │
│ • Theme 2: Mechanisms (PMIDs)                       │
│ • Theme 3: Guidelines                               │
│                                                      │
│ CLINICAL IMPLICATIONS                                │
│ • What this means for your content                  │
│                                                      │
│ KEY PMIDS TO CITE                                    │
│ • List of 5-7 citation-ready references             │
└─────────────────────────────────────────────────────┘
```

---

## Usage

### Interactive Mode (Recommended)

Ask Claude:

```
Use quick-topic-researcher for [TOPIC] in [DOMAIN]
```

Example:
```
Use quick-topic-researcher for "SGLT2 inhibitors in CKD" in "Cardiology/Nephrology"
```

### CLI Mode (Coming Soon)

```bash
python skills/cardiology/quick-topic-researcher/scripts/quick_research.py \
    --topic "GLP-1 agonists in heart failure" \
    --domain "Cardiology"
```

---

## Research Sources

### Primary (Citable)
| Source | Tool | Purpose |
|--------|------|---------|
| **PubMed MCP** | `pubmed_search_articles`, `pubmed_fetch_contents` | All medical evidence |
| **Guidelines** | Direct URL fetch to ACC/ESC/ADA | Recommendations |

### Discovery (Not Citable)
| Source | Tool | Purpose |
|--------|------|---------|
| **Perplexity** | `perplexity_ask` via MCP | Quick context, trend discovery |
| **Web Search** | `WebSearch` | Background, non-medical context |

**Rule:** You can USE Perplexity to understand context, but you CITE only PubMed.

---

## Output Format

The skill outputs a structured brief:

```markdown
# Quick Research Brief: [TOPIC]

**Domain:** [DOMAIN]
**Generated:** [DATE]
**Time to Read:** 3 minutes

---

## Executive Summary

[2-3 sentences: What you need to know before recording/writing]

Key takeaway: [ONE sentence with strongest PMID]

---

## Research Questions & Findings

### Q1: [Question]
**Answer:** [Concise answer]
**Evidence:** [Study name, PMID, key stat (HR, CI, p-value)]

### Q2: [Question]
**Answer:** [Concise answer]
**Evidence:** [Study name, PMID, key stat]

[... Q3-Q5 ...]

---

## Clinical Context

### What Guidelines Say
[ACC/ESC/ADA recommendations with class/level]

### Practice Implications
[What this means for real patients]

---

## Content Hooks

For your video/content, consider these angles:
1. [Hook 1 based on findings]
2. [Hook 2 based on findings]
3. [Hook 3 based on findings]

---

## Citation-Ready References

1. Author A, et al. TRIAL-NAME. Journal. Year. PMID: XXXXXXXX
2. Author B, et al. Study Name. Journal. Year. PMID: XXXXXXXX
3. [5-7 total references]

---

## Gaps & Caveats

- [What the evidence doesn't cover]
- [Patient populations with limited data]
```

---

## Integration with Content Pipeline

### Before YouTube Script
```
1. Run quick-topic-researcher on your video topic
2. Review the brief (3 min read)
3. Open youtube-script-master with the brief in context
4. Script now has verified facts and PMIDs
```

### Before Tweet Thread
```
1. Run quick-topic-researcher
2. Pick 1-2 key findings from the brief
3. Use x-post-creator-skill with specific PMIDs
```

### Before Newsletter
```
1. Run quick-topic-researcher for quick take
2. If topic is complex, follow up with deep-researcher
3. Write with cardiology-newsletter-writer
```

---

## Example Session

**User:** Use quick-topic-researcher for "colchicine in cardiovascular prevention" in "Cardiology"

**Claude:**

I'll research this topic rapidly using PubMed and generate a brief.

**Step 1: Generating 5 research questions...**

1. Does colchicine reduce major cardiovascular events in CAD patients?
2. What are the key RCTs (COLCOT, LoDoCo2, CLEAR SYNERGY)?
3. What is the proposed anti-inflammatory mechanism?
4. What are the safety concerns and contraindications?
5. What do current guidelines recommend?

**Step 2: Parallel research...**

[Executes 5 PubMed searches in parallel]
[Fetches key article abstracts]
[Searches Perplexity for context]

**Step 3: Generating McKinsey-style brief...**

---

# Quick Research Brief: Colchicine in CV Prevention

**Domain:** Cardiology
**Generated:** 2026-01-01
**Time to Read:** 3 minutes

## Executive Summary

Low-dose colchicine (0.5mg daily) reduces cardiovascular events in patients with established coronary artery disease through anti-inflammatory mechanisms. COLCOT and LoDoCo2 showed consistent benefit; CLEAR SYNERGY was neutral but in a different population.

Key takeaway: **In stable CAD patients, colchicine 0.5mg daily reduces CV events by ~25% (HR 0.69-0.77)** (PMID: 31733140, 32865377)

## Research Questions & Findings

### Q1: Does colchicine reduce major CV events?
**Answer:** Yes, in stable CAD
**Evidence:** LoDoCo2: HR 0.69 (0.57-0.83), p<0.001 for CV death/MI/stroke (PMID: 32865377)

### Q2: What are the key trials?
**Answer:** COLCOT (post-MI), LoDoCo2 (chronic CAD), CLEAR SYNERGY (post-PCI)
**Evidence:**
- COLCOT: 0.5mg, HR 0.77 for composite (PMID: 31733140)
- LoDoCo2: 0.5mg, HR 0.69 for composite (PMID: 32865377)
- CLEAR SYNERGY: Neutral for primary endpoint (PMID: 37634428)

### Q3: What is the mechanism?
**Answer:** NLRP3 inflammasome inhibition, IL-1β reduction
**Evidence:** Reduces hsCRP; targets residual inflammatory risk (PMID: 29724838)

### Q4: Safety concerns?
**Answer:** GI side effects, myopathy with statins, CKD dose adjustment
**Evidence:** NNH for GI: ~50; avoid with strong CYP3A4 inhibitors (PMID: 31733140)

### Q5: Guidelines?
**Answer:** Class IIb in ESC 2024 for chronic CAD
**Evidence:** ESC 2024 CCS Guidelines, consider in patients with elevated hsCRP

## Clinical Context

### What Guidelines Say
ESC 2024: Class IIb, Level A - "Colchicine 0.5mg may be considered to reduce