name: discussion description: Draft or revise discussion sections for empirical or theoretical papers.
Skill: discussion
Structure
Empirical Papers
- Recap patterns – most important findings in plain language
- Interpretation – theoretical and practical implications
- Limitations – honest but framed as tradeoffs when appropriate
- Future work – specific, grounded suggestions Propose concrete follow-up studies, not generic directions. See writing-craft, "Contribution Framing," and mcguire-heuristics.
- Take-home message – concise, memorable conclusion
Theoretical Papers
- Synthesize arguments – how the perspective changes research
- Implications – what researchers should do differently
- Limitations – scope and boundary conditions
- Future directions – concrete next steps Propose concrete follow-up studies, not generic directions. See writing-craft, "Contribution Framing," and mcguire-heuristics.
For perspectivism and follow-up heuristics, load writing-craft alongside this skill.
Rules
- Don't repeat results verbatim; synthesize across studies
- Don't introduce new literature not covered in lit review
- Don't overstate conclusions beyond data support
- Don't end with vague future directions; end with concrete take-home
Workflow
- Outline key messages first
- Draft interpretation paragraphs
- Add limitations and future work
- Craft punchy conclusion
#examples-disclaimer