Get the FREE Ultimate OpenClaw Setup Guide →

discussion-section-architect

npx machina-cli add skill aipoch/medical-research-skills/discussion-section-architect --openclaw
Files (1)
SKILL.md
2.5 KB

Discussion Section Architect

Structured framework for writing Discussion sections.

Use Cases

  • Manuscript discussion writing
  • Thesis discussion chapters
  • Organizing complex findings

Parameters

ParameterTypeRequiredDefaultDescription
findingslist[str]Yes-Key results to discuss
literature_contextstrNo-Relevant prior work summary
limitationslist[str]No-Study limitations to address
implicationslist[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 IndicatorAssessmentLevel
Code ExecutionPython/R scripts executed locallyMedium
Network AccessNo external API callsLow
File System AccessRead input files, write output filesMedium
Instruction TamperingStandard prompt guidelinesLow
Data ExposureOutput files saved to workspaceLow

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

  1. Basic Functionality: Standard input → Expected output
  2. Edge Case: Invalid input → Graceful error handling
  3. 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

  1. Step 1: Provide findings as a list of key results
  2. Step 2: Optionally add literature_context, limitations, and implications
  3. 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

Add this skill to your agents

Related Skills

Sponsor this space

Reach thousands of developers