discussion-section-architect
npx machina-cli add skill aipoch/medical-research-skills/discussion-section-architect --openclawDiscussion Section Architect
Structured framework for writing Discussion sections.
Use Cases
- Manuscript discussion writing
- Thesis discussion chapters
- Organizing complex findings
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
findings | list[str] | Yes | - | Key results to discuss |
literature_context | str | No | - | Relevant prior work summary |
limitations | list[str] | No | - | Study limitations to address |
implications | list[str] | No | - | Clinical or research implications |
Returns
- Structured discussion outline
- Paragraph-by-paragraph guidance
- Connection suggestions
Example
Guides: Summary → Literature comparison → Mechanism → Limitations → Future directions
Risk Assessment
| Risk Indicator | Assessment | Level |
|---|---|---|
| Code Execution | Python/R scripts executed locally | Medium |
| Network Access | No external API calls | Low |
| File System Access | Read input files, write output files | Medium |
| Instruction Tampering | Standard prompt guidelines | Low |
| Data Exposure | Output files saved to workspace | Low |
Security Checklist
- No hardcoded credentials or API keys
- No unauthorized file system access (../)
- Output does not expose sensitive information
- Prompt injection protections in place
- Input file paths validated (no ../ traversal)
- Output directory restricted to workspace
- Script execution in sandboxed environment
- Error messages sanitized (no stack traces exposed)
- Dependencies audited
Prerequisites
No additional Python packages required.
Evaluation Criteria
Success Metrics
- Successfully executes main functionality
- Output meets quality standards
- Handles edge cases gracefully
- Performance is acceptable
Test Cases
- Basic Functionality: Standard input → Expected output
- Edge Case: Invalid input → Graceful error handling
- Performance: Large dataset → Acceptable processing time
Lifecycle Status
- Current Stage: Draft
- Next Review Date: 2026-03-06
- Known Issues: None
- Planned Improvements:
- Performance optimization
- Additional feature support
Source
git clone https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Academic writing/discussion-section-architect/SKILL.mdView on GitHub Overview
Discussion Section Architect provides a guided framework for organizing and writing academic Discussion sections. It targets manuscripts, theses, and complex findings by outlining key elements such as findings, literature context, limitations, and implications, ensuring clear, logical flow.
How This Skill Works
Users supply a findings list and optional context (literature_context), limitations, and implications. The tool then outputs a structured discussion outline, paragraph-by-paragraph guidance, and connection suggestions to tie results to prior work and future directions.
When to Use It
- Drafting a manuscript discussion section to clearly convey results
- Developing a thesis discussion chapter with multiple findings
- Organizing complex findings across subtopics
- Addressing limitations and linking to literature context
- Planning implications and future directions for research or clinical practice
Quick Start
- Step 1: Provide findings as a list of key results
- Step 2: Optionally add literature_context, limitations, and implications
- Step 3: Generate and refine the structured outline and guidance
Best Practices
- Start with a findings-driven outline that mirrors the results
- Incorporate literature_context early to frame comparisons
- Map each finding to implications and limitations for coherence
- Leverage the provided parameters (findings, literature_context, limitations, implications)
- Review and refine paragraph-by-paragraph guidance to fit journal/style requirements
Example Use Cases
- Manuscript discussion outlining how findings compare with prior studies and proposed mechanisms
- Thesis chapter structure showing limitations and future directions
- Complex study with heterogeneous results organized by subtopics and connections to literature
- Clinical research discussion linking findings to implications for practice
- Pre-submission revision using reviewer-style prompts and connection suggestions
Frequently Asked Questions
Related Skills
dei-statement-drafter
aipoch/medical-research-skills
Draft Diversity, Equity, and Inclusion statements for academic applications
funding-trend-forecaster
aipoch/medical-research-skills
Predict funding trend shifts using NLP analysis of grant abstracts from
figure-legend-gen
aipoch/medical-research-skills
Generate standardized figure legends for scientific charts and graphs.
figure-reference-checker
aipoch/medical-research-skills
Check figure references in manuscripts
conflict-of-interest-checker
aipoch/medical-research-skills
Check for co-authorship conflicts between authors and suggested reviewers
conference-poster-pitch
aipoch/medical-research-skills
Generate elevator pitch for conference posters