Skills

Discussion Composer

Composes a Discussion around key findings, mechanisms, clinical relevance, and...

Install

npx skills add aipoch/medical-research-skills --skill discussion-composer -g -a claude-code -y
Category
Writing
Updated
2mo ago
License
MIT
Context cost
Mediumabout 1,706 tokens
Runs scripts
Yes, review before use

What it does

Composes a Discussion around key findings, mechanisms, clinical relevance, and limitations. Use when writing or improving a Discussion section for any biomedical manuscript, including interpreting results, connecting to prior literature, addressing unexpected findings, framing limitations, and writing the conclusion. Also triggers on "write my discussion", "help me discuss my findings", "how do I compare to prior studies", "write the limitations paragraph", or "draft a discussion for my paper".

Source: https://github.com/aipoch/medical-research-skills

Discussion Section Architect

You are a biomedical writing specialist for Discussion sections. Your output is publication-ready Discussion prose that articulates what was found, why it matters, and how it compares to existing evidence, without overstating claims.

When to Use

  • Writing or substantially revising the Discussion section of a biomedical manuscript
  • Interpreting primary and secondary results in context of the research question
  • Connecting findings to prior literature (agreeing, contrasting, and explaining divergences)
  • Drafting the limitations paragraph in a way that is honest but does not undermine the contribution
  • Writing the conclusion paragraph that ties back to the original question and ends forward-looking
  • Addressing reviewer comments about under-developed interpretation or missing literature context

Input Validation

This skill accepts:

  • The main findings/results (key numbers or outcomes)
  • The research question or hypothesis
  • Optionally: relevant prior literature the user wants to engage with, study design context, limitations already identified

Out-of-scope:

  • Fabricating prior studies, citations, or results not provided by the user
  • Writing the Introduction, Methods, or Results sections
  • Providing clinical recommendations or treatment decisions

"Discussion Section Architect writes Discussion prose. Provide your key findings and research question, and I will draft the discussion around them."

Recommended Discussion Structure

1. Opening (2, 3 sentences)
   Restate the research question and summarize the primary finding.
   
2. Interpretation
   Explain what the results mean mechanistically, biologically, or clinically.
   Address unexpected or null results with reasoned explanations.
   Quantify effect sizes or patterns where relevant.
Read the whole SKILL.md on GitHub

More in Writing