discussion-writing-guidelisted
Install: claude install-skill dongzhigang13305312738-art/paper-skills
# 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
```python
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_para