MCPInstall

medical-newsletter-writer

Create evidence-based medical newsletters for interventional cardiologists in Eric Topol's authoritative Ground Truths style. Use when the user wants to analyze trending medical topics with engagement predictions, conduct data-driven topic selection, research medical literature using PubMed, or write comprehensive well-referenced newsletters that build professional authority. Handles complete workflow from trend analysis to final draft.

Installs
73
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/drshailesh88/integrated_content_os --skill medical-newsletter-writer
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads medical-newsletter-writer automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Medical Newsletter Writer

Create high-quality, evidence-based medical newsletters in the style of Eric Topol's Ground Truths. This skill guides the complete newsletter creation process: from analyzing your PDF of topic ideas, to deep PubMed research, to writing in Topol's distinctive authoritative-yet-accessible voice.

Quick Start

Simple 3-Step Process:

  1. Upload PDF - Upload your PDF with topic ideas in the chat
  2. Select Topic - Review engagement predictions and pick one topic
  3. Get Newsletter - Receive complete, publication-ready newsletter (~3,000 words with 20-30 PubMed citations)

The skill handles everything: PDF extraction, trend analysis, PubMed research, and writing in Eric Topol's exact voice.

Complete Workflow

The newsletter creation process has 5 phases:

  1. Extract Topics from PDF - Read user's uploaded PDF of topic ideas
  2. Trend Analysis - Analyze each topic for engagement potential
  3. Topic Selection - User approves topics based on data-driven predictions
  4. Deep Research - Comprehensive PubMed literature review
  5. Newsletter Writing - Write complete newsletter in Topol's style

Phase 1: Extract Topics from PDF

PDF Upload

User will upload a PDF containing potential newsletter topic ideas in the chat.

Extract Topics

  • Read the PDF using available tools
  • Extract all topic ideas mentioned
  • Clean and organize the list
  • If PDF contains notes/context about topics, capture that too

Phase 2: Trend Analysis & Engagement Prediction

Analyze Each Topic (Automatically)

For each topic extracted from the PDF, conduct comprehensive trend analysis:

1. News Coverage (Google News, medical news sites)

  • Search past 30 days
  • Note which outlets covering
  • Identify breaking developments
  • Count article frequency

2. Search Interest

  • Use web_search to assess current discussion
  • Look for rising interest signals
  • Note if topic is trending

3. Social Media Signals

  • YouTube: Search for videos, note view counts
  • Check if medical professionals are discussing
  • Assess virality potential

4. Academic Momentum (PubMed)

  • Count recent publications (6 months)
  • Check for major journal coverage
  • Identify ongoing trials
  • Note if field is active

Engagement Prediction Scoring

For each topic, score 1-10 on:

  1. Readability: Can this be explained clearly to physicians?
  2. Controversy: Is there debate/opposing views?
  3. Clinical Relevance: Will this affect patient care?
  4. Timeliness: How current is this? Breaking news?
  5. Share Potential: Will physicians share with colleagues?

Overall Engagement Score = Average of 5 metrics

Present Analysis

Create comparison table with:

  • Topic name
  • Brief trend summary (2-3 sentences)
  • Individual scores (1-10)
  • Overall engagement score
  • Priority recommendation (High/Medium/Low)

Sort by overall score, present top 5-10 topics to user.

Phase 3: Topic Selection

Present findings to user with:

  • Top topics by engagement prediction
  • Rationale for scores
  • Notable timeliness factors

User selects ONE topic - then the skill automatically proceeds to research and writing.

Phase 4: Deep Research (Automatic)

PubMed Search Strategy

Before searching, read workflow.md for detailed research guidance.

Initial searches:

  1. Broad topic overview
  2. Recent findings (<1 year)
  3. Systematic reviews/meta-analyses
  4. Major clinical trials

Paper Prioritization:

  • Tier 1: Large RCTs in NEJM, Lancet, JAMA, Science, Nature
  • Tier 2: Meta-analyses and systematic reviews
  • Tier 3: Large observational studies
  • Tier 4: Mechanistic studies in high-impact journals
  • Tier 5: Pre-clinical (use sparingly)

Target: 15-30 highly relevant papers

Extract Key Information

For each major paper:

  • Study design and sample size
  • Key findings (quantitative)
  • Limitations
  • How it fits the narrative
  • Potential quotes/figures

Find Related Work

  • Use PubMed related articles
  • Check major paper citations
  • Look for responses/commentary
  • Identify consensus vs. controversy

Phase 5: Newsletter Writing (Automatic)

Before Writing

CRITICAL: Read topol-style-guide.md first - This contains essential voice patterns, phrases, and stylistic requirements.

Structure

Opening (1-2 paragraphs)

  • Hook using Topol's opening patterns (see style guide)
  • Why this matters NOW
  • What will be covered

Background/Context (optional)

  • Define key terms: "To review: [term] is..."
  • Historical perspective if relevant
  • Current state of field

Main Content (3-5 sections with clear headers)

  • Each section = one major subtopic
  • Build logically
  • Include data/studies in each
  • Use tables to compare studies/treatments
  • Reference figures from papers

Implications/Future Directions

  • What this means for practice
  • Research gaps
  • What's next

Bottom Line (required)

  • Synthesize key takeaways
  • Clear conclusions based on evidence
  • Call for more evidence if needed

Standard Closing (required)

Thanks for reading and subscribing to Ground Truths.

If you found this interesting PLEASE share it!

That makes the work involved in putting these together especially worthwhile.

All content on Ground Truths—its newsletters, analyses, and podcasts, are free, open-access.

Paid subscriptions are voluntary and all proceeds from them go to support Scripps Research. They do allow for posting comments and questions, which I do my best to respond to. Please don't hesitate to post comments and give me feedback. Let me know topics that you would like to see covered.

Writing Requirements

Voice & Style:

  • First person engaged ("I recently fielded questions...")
  • Authoritative but accessible
  • Critical and evidence-based
  • Use Topol's signature phrases (see style guide)

Citations:

  • EVERY factual claim needs a PubMed citation with hyperlink
  • Format: link text embedded in prose
  • Cite original studies, not news articles
  • Include author names for major findings: "Professor X and colleagues at Y University published in Z..."

Critical Analysis:

  • Always discuss study limitations
  • Note conflicts of interest if relevant
  • Present alternative interpretations
  • Flag when evidence is preliminary
  • Call out hype vs. data

Length: 2,000-3,500 words

Visual Elements:

  • Create tables comparing studies/treatments
  • Describe figures from papers
  • Use clear section headers

Quality Checks

Before finalizing:

  • Engaging opening hook?
  • Clear why-this-matters framing?
  • Every claim cited?
  • Limitations discussed?
  • Topol's voice consistent?
  • Tables/figures included?
  • Logical flow?
  • "Bottom Line" section?
  • Standard closing?
  • 2,000-3,500 words?

Delivery

Final Format

  • Complete newsletter in Markdown
  • All hyperlinked citations to PubMed
  • 2,000-3,500 words
  • Ready for user's newsletter platform

Customization Note

User may want to change "Scripps Research" in the standard closing to their own institution/practice name.

Essential References

ALWAYS READ BEFORE WRITING:

  • topol-style-guide.md - Complete guide to Topol's voice, phrases, patterns
  • workflow.md - Detailed research and writing process

Key Success Factors

  1. Evidence-based: Every claim must be cited
  2. Critical thinking: Discuss limitations, not just positives
  3. Voice consistency: Sound like Topol throughout
  4. Comprehensive: Cover topic thoroughly with multiple studies
  5. Accessible: Technical accuracy without excessive jargon
  6. Timely: Focus on recent developments
  7. Visual: Include tables/figures to enhance understanding
  8. Engaging: Hook readers immediately, maintain interest

Example Opening Lines (Topol Style)

  • "In fielding questions recently from patients and colleagues about [topic], I was prompted to look into the field at more depth."
  • "[Term] was coined in the late [year]. Now, about [X] years later, we've yet to achieve [goal]."
  • "This week [major development] was published in [journal]. Several important reports have since been published. I've incorporated them in this updated version."
  • "There's no question that the use of [intervention] has surged, in part because of [claims], along with endorsements by [influencers]."

Common Pitfalls to Avoid

  • Don't rely on single studies - use multiple sources
  • Don't ignore study limitations - they're critical
  • Don't cherry-pick data - present full picture
  • Don't get too technical - stay accessible
  • Don't use bullet points excessively - prefer prose
  • Don't skip the critical analysis - it's essential
  • Don't forget visual elements - tables enhance understanding
  • Don't deviate from Topol's voice - consistency matters

FAQ

What does the medical-newsletter-writer skill do?

Create evidence-based medical newsletters for interventional cardiologists in Eric Topol's authoritative Ground Truths style. Use when the user wants to analyze trending medical topics with engagement predictions, conduct data-driven topic selection, research medical literature using PubMed, or write comprehensive well-referenced newsletters that build professional authority. Handles complete workflow from trend analysis to final draft.

How do I install medical-newsletter-writer?

Run npx skills add https://github.com/drshailesh88/integrated_content_os --skill medical-newsletter-writer in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/medical-newsletter-writer/ (personal) or .claude/skills/medical-newsletter-writer/ (project).

Which AI agents can use medical-newsletter-writer?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is medical-newsletter-writer safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains medical-newsletter-writer?

It is published by drshailesh88 in drshailesh88/integrated_content_os. It has 73 recorded installs.

More from drshailesh88/integrated_content_os

View all →

social-media-trends-research

drshailesh88/integrated_content_os

Programmatic social media and marketing research using free tools: pytrends (Google Trends), yars (Reddit without API keys), and Perplexity MCP (Twitter/TikTok/Web). Use when finding trending topics in a niche, tracking keyword velocity and volume, monitoring Reddit discussions, discovering what's going viral, or researching content opportunities before writing. Zero-cost research stack with built-in rate limiting. Complements content-marketing-social-listening skill with executable code.

Marketing & SEO708 installs

deep-researcher

drshailesh88/integrated_content_os

Performs comprehensive, multi-layered research on any topic with structured analysis and synthesis of information from multiple sources. Uses file-based research tracking, parallel investigation threads, and context-efficient patterns for deep investigations. ALL MEDICAL CITATIONS FROM PUBMED MCP ONLY.

academic-chapter-writer

drshailesh88/integrated_content_os

Comprehensive academic textbook chapter writing system for medical/scientific content. Use when the user wants to: (1) Write a full textbook chapter (5,000-15,000 words) on any medical/scientific topic, (2) Generate a detailed table of contents with section word counts, (3) Research topics via PubMed MCP and compile 20-30 references, (4) Write section-by-section with proper citations in Vancouver format, (5) Create publishable academic content with Eric Topol-inspired voice and authentic human prose, (6) Get approval at TOC stage before writing begins, (7) Export well-structured chapters for textbook publication.

viral-content-predictor

drshailesh88/integrated_content_os

Analyzes medical education content ideas from PDFs/DOCX files to predict viral potential (views, likes, shares, AVD) and provides actionable insights. Use when the user needs to evaluate content ideas for engagement potential, get predictive analytics on video performance, research trending topics in medical/health niches, analyze YouTube comments and audience sentiment, identify knowledge gaps and myths, or prioritize content ideas based on viral likelihood.

youtube-script-master

drshailesh88/integrated_content_os

Unified YouTube script creation for cardiology channels in Hinglish. Uses the COMPLETE research-engine pipeline (channel scraping, comment analysis, narrative monitoring, gap finding, view prediction) combined with RAG + PubMed for evidence. Data-driven topic selection, 15-30 min educational videos with 6-point voice check.

influencer-analyzer

drshailesh88/integrated_content_os

Track and analyze cardiology content creators (Topol, Attia, York Cardiology, Indian channels). Discovers content patterns, topics, engagement, and gap opportunities for your Hinglish content strategy.

Marketing & SEO49 installs

Popular education & science skills

View category →

teach

mattpocock/skills

Teach the user a new skill or concept, within this workspace.

Education & Science874K installs

scaffold-exercises

mattpocock/skills

Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.

Education & Science488.2K installs

paper-context-resolver

lllllllama/rigorpilot-skills

Rigor Paper Context helper for README-first deep learning repo reproduction. Use only when the README and repository files leave a narrow reproduction-critical gap and the task is to resolve a specific paper detail such as dataset split, preprocessing, evaluation protocol, checkpoint mapping, or runtime assumption from primary paper sources while recording conflicts. Do not use for general paper summary, repo scanning, environment setup, command execution, title-only paper lookup, or replacing README guidance by default.

Education & Science478.3K installs

caveman-learn

juliusbrussee/caveman

Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes returned. Use when asked to lower an agent's token cost, what caveman has saved, to trim a heavy CLAUDE.md, or to offload re-pasted context into cavemem.

Education & Science107.9K installs

gsap-plugins

greensock/gsap-skills

Official GSAP skill for GSAP plugins — registration, ScrollToPlugin, ScrollSmoother, Flip, Draggable, Inertia, Observer, SplitText, ScrambleText, SVG and physics plugins, CustomEase, EasePack, CustomWiggle, CustomBounce, GSDevTools. Use when the user asks about a GSAP plugin, scroll-to, flip animations, draggable, SVG drawing, or plugin registration.

Education & Science67.9K installs

teach-impeccable

pbakaus/impeccable

DEPRECATED: Use /impeccable teach instead. This command has been folded into the impeccable skill.