
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- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads medical-newsletter-writer automatically when relevant.
- 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:
- Upload PDF - Upload your PDF with topic ideas in the chat
- Select Topic - Review engagement predictions and pick one topic
- 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:
- Extract Topics from PDF - Read user's uploaded PDF of topic ideas
- Trend Analysis - Analyze each topic for engagement potential
- Topic Selection - User approves topics based on data-driven predictions
- Deep Research - Comprehensive PubMed literature review
- 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:
- Readability: Can this be explained clearly to physicians?
- Controversy: Is there debate/opposing views?
- Clinical Relevance: Will this affect patient care?
- Timeliness: How current is this? Breaking news?
- 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:
- Broad topic overview
- Recent findings (<1 year)
- Systematic reviews/meta-analyses
- 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
- Evidence-based: Every claim must be cited
- Critical thinking: Discuss limitations, not just positives
- Voice consistency: Sound like Topol throughout
- Comprehensive: Cover topic thoroughly with multiple studies
- Accessible: Technical accuracy without excessive jargon
- Timely: Focus on recent developments
- Visual: Include tables/figures to enhance understanding
- 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
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.
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.
Popular education & science skills
teach
mattpocock/skills
Teach the user a new skill or concept, within this workspace.
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.
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.
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.
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.
teach-impeccable
pbakaus/impeccable
DEPRECATED: Use /impeccable teach instead. This command has been folded into the impeccable skill.