SKILL.md
Discussion Writing Guide
A skill for writing compelling discussion sections in academic papers. Covers the standard structure, strategies for interpreting results, addressing limitations, connecting to existing literature, and articulating the broader implications of your findings.
Discussion Section Structure
The Hourglass Model
The discussion mirrors the introduction in reverse -- it starts narrow (your specific findings) and broadens to implications:
Introduction: Broad context -> Specific gap -> Your question
Discussion: Your findings -> Broader literature -> Implications
Standard Structure:
1. Summary of key findings (1-2 paragraphs)
2. Interpretation and comparison with literature (bulk of section)
3. Limitations (1-2 paragraphs)
4. Implications and future directions (1-2 paragraphs)
5. Conclusion (optional, or as separate section)
Paragraph-Level Template
def outline_discussion(findings: list[dict],
literature_connections: list[dict],
limitations: list[str],
implications: list[str]) -> dict:
"""
Generate a structured discussion outline.
Args:
findings: List of dicts with 'result' and 'interpretation'
literature_connections: Dicts with 'finding', 'related_work', 'comparison'
limitations: List of limitation statements
implications: List of implication statements
"""
outline = {
"opening_paragraph": {
"purpose": "Restate the research question and summarize key findings",
"template": (
"This study examined [research question]. "
"The principal finding was [main result], "
"which [supports/contradicts/extends] [hypothesis or expectation]."
),
"tips": [
"Do NOT repeat numbers from Results -- summarize in words",
"State whether hypotheses were supported",
"Lead with the most important finding"
]
},
"interpretation_paragraphs": [
{
"finding": f["result"],
"interpretation": f["interpretation"],
"literature": next(
(lc for lc in literature_connections
if lc["finding"] == f["result"]), None
)
}
for f in findings
],
"limitations": {
"items": limitations,
"tip": "Frame limitations honestly but not apologetically"
},
"implications": {
"items": implications,
"tip": "Distinguish practical implications from theoretical ones"
}
}
return outline
