hypothesis-generation
This Claude Code skill generates testable scientific hypotheses by systematically formulating evidence-based explanations from observations, designing experiments, and exploring competing explanations across scientific domains. Use it when developing hypotheses from preliminary data, designing experiments to test research questions, exploring alternative explanations for phenomena, or planning mechanistic studies requiring structured hypothesis generation and visual documentation through required scientific schematics.
git clone --depth 1 https://github.com/K-Dense-AI/claude-scientific-writer /tmp/hypothesis-generation && cp -r /tmp/hypothesis-generation/skills/hypothesis-generation ~/.claude/skills/hypothesis-generationSKILL.md
# Scientific Hypothesis Generation ## Overview Hypothesis generation is a systematic process for developing testable explanations. Formulate evidence-based hypotheses from observations, design experiments, explore competing explanations, and develop predictions. Apply this skill for scientific inquiry across domains. ## When to Use This Skill This skill should be used when: - Developing hypotheses from observations or preliminary data - Designing experiments to test scientific questions - Exploring competing explanations for phenomena - Formulating testable predictions for research - Conducting literature-based hypothesis generation - Planning mechanistic studies across scientific domains ## Visual Enhancement with Scientific Schematics **⚠️ MANDATORY: Every hypothesis generation report MUST include at least 1-2 AI-generated figures using the scientific-schematics skill.** This is not optional. Hypothesis reports without visual elements are incomplete. Before finalizing any document: 1. Generate at minimum ONE schematic or diagram (e.g., hypothesis framework showing competing explanations) 2. Prefer 2-3 figures for comprehensive reports (mechanistic pathway, experimental design flowchart, prediction decision tree) **How to generate figures:** - Use the **scientific-schematics** skill to generate AI-powered publication-quality diagrams - Simply describe your desired diagram in natural language - Nano Banana Pro will automatically generate, review, and refine the schematic **How to generate schematics:** ```bash python scripts/generate_schematic.py "your diagram description" -o figures/output.png ``` The AI will automatically: - Create publication-quality images with proper formatting - Review and refine through multiple iterations - Ensure accessibility (colorblind-friendly, high contrast) - Save outputs in the figures/ directory **When to add schematics:** - Hypothesis framework diagrams showing competing explanations - Experimental design flowcharts - Mechanistic pathway diagrams - Prediction decision trees - Causal relationship diagrams - Theoretical model visualizations - Any complex concept that benefits from visualization For detailed guidance on creating schematics, refer to the scientific-schematics skill documentation. --- ## Workflow Follow this systematic process to generate robust scientific hypotheses: ### 1. Understand the Phenomenon Start by clarifying the observation, question, or phenomenon that requires explanation: - Identify the core observation or pattern that needs explanation - Define the scope and boundaries of the phenomenon - Note any constraints or specific contexts - Clarify what is already known vs. what is uncertain - Identify the relevant scientific domain(s) ### 2. Conduct Comprehensive Literature Search Search existing scientific literature to ground hypotheses in current evidence. Use both PubMed (for biomedical topics) and general web search (for broader scientific domains): **For biomedical topics:** - Use WebFetch with PubMed URLs to access relevant literature - Search for recent reviews, meta-analyses, and primary research - Look for similar phenomena, related mechanisms, or analogous systems **For all scientific domains:** - Use WebSearch to find recent papers, preprints, and reviews - Search for established theories, mechanisms, or frameworks - Identify gaps in current understanding **Search strategy:** - Begin with broad searches to understand the landscape - Narrow to specific mechanisms, pathways, or theories - Look for contradictory findings or unresolved debates - Consult `references/literature_search_strategies.md` for detailed search techniques ### 3. Synthesize Existing Evidence Analyze and integrate findings from literature search: - Summarize current understanding of the phenomenon - Identify established mechanisms or theories that may apply - Note conflicting evidence or alternative viewpoints - Recognize gaps, limitations, or unanswered questions - Identify analogies from related systems or domains ### 4. Generate Competing Hypotheses Develop 3-5 distinct hypotheses that could explain the phenomenon. Each hypothesis should: - Provide a mechanistic explanation (not just description) - Be distinguishable from other hypotheses - Draw on evidence from the literature synthesis - Consider different levels of explanation (molecular, cellular, systemic, population, etc.) **Strategies for generating hypotheses:** - Apply known mechanisms from analogous systems - Consider multiple causative pathways - Explore different scales of explanation - Question assumptions in existing explanations - Combine mechanisms in novel ways ### 5. Evaluate Hypothesis Quality Assess each hypothesis against established quality criteria from `references/hypothesis_quality_criteria.md`: **Testability:** Can the hypothesis be empirically tested? **Falsifiability:** What observations would disprove it? **Parsimony:** Is it the simplest explanation that fits the evidence? **Explanatory Power:** How much of the phenomenon does it explain? **Scope:** What range of observations does it cover? **Consistency:** Does it align with established principles? **Novelty:** Does it offer new insights beyond existing explanations? Explicitly note the strengths and weaknesses of each hypothesis. ### 6. Design Experimental Tests For each viable hypothesis, propose specific experiments or studies to test it. Consult `references/experimental_design_patterns.md` for common approaches: **Experimental design elements:** - What would be measured or observed? - What comparisons or controls are needed? - What methods or techniques would be used? - What sample sizes or statistical approaches are appropriate? - What are potential confounds and how to address them? **Consider multiple approaches:** - Laboratory experiments (in vitro, in vivo, computational) - Observational studies (cross-sectional, longitudinal, case-control) - Clinical trials (if applicable) -
Comprehensive citation management for academic research. Search Google Scholar and PubMed for papers, extract accurate metadata, validate citations, and generate properly formatted BibTeX entries. This skill should be used when you need to find papers, verify citation information, convert DOIs to BibTeX, or ensure reference accuracy in scientific writing.
Generate professional clinical decision support (CDS) documents for pharmaceutical and clinical research settings, including patient cohort analyses (biomarker-stratified with outcomes) and treatment recommendation reports (evidence-based guidelines with decision algorithms). Supports GRADE evidence grading, statistical analysis (hazard ratios, survival curves, waterfall plots), biomarker integration, and regulatory compliance. Outputs publication-ready LaTeX/PDF format optimized for drug development, clinical research, and evidence synthesis.
Write comprehensive clinical reports including case reports (CARE guidelines), diagnostic reports (radiology/pathology/lab), clinical trial reports (ICH-E3, SAE, CSR), and patient documentation (SOAP, H&P, discharge summaries). Full support with templates, regulatory compliance (HIPAA, FDA, ICH-GCP), and validation tools.
Document toolkit (.docx). Create/edit documents, tracked changes, comments, formatting preservation, text extraction, for professional document processing.
PDF manipulation toolkit. Extract text/tables, create PDFs, merge/split, fill forms, for programmatic document processing and analysis.
Presentation toolkit (.pptx). Create/edit slides, layouts, content, speaker notes, comments, for programmatic presentation creation and modification.
Spreadsheet toolkit (.xlsx/.csv). Create/edit with formulas/formatting, analyze data, visualization, recalculate formulas, for spreadsheet processing and analysis.
Generate or edit images using AI models (FLUX, Gemini). Use for general-purpose image generation including photos, illustrations, artwork, visual assets, concept art, and any image that isn't a technical diagram or schematic. For flowcharts, circuits, pathways, and technical diagrams, use the scientific-schematics skill instead.