Skip to content

Latest commit

 

History

History
951 lines (767 loc) · 39.3 KB

File metadata and controls

951 lines (767 loc) · 39.3 KB

Available Skills

Scientific Writer is a deep research and writing tool that combines AI-driven deep research with well-formatted written outputs. The skills below power this capability—from conducting literature searches and verifying citations to generating publication-ready documents in various formats.

This document provides an overview of all skills available in the Scientific Writer CLI.

Writing Skills

1. Scientific Writing

Location: .claude/skills/scientific-writing/

Capabilities:

  • IMRaD structure guidance (Introduction, Methods, Results, and Discussion)
  • Citation styles (APA, MLA, Chicago, Nature, Science, etc.)
  • Figure and table formatting best practices
  • Reporting guidelines for various study types
  • Writing principles for clarity, precision, and scientific rigor

References:

  • citation_styles.md: Comprehensive guide to major citation formats
  • figures_tables.md: Best practices for presenting data
  • imrad_structure.md: Detailed guidance on each section
  • reporting_guidelines.md: Standards for clinical trials, observational studies, etc.
  • writing_principles.md: Core principles of scientific communication

2. Literature Review

Location: .claude/skills/literature-review/

Capabilities:

  • Conducting systematic literature searches
  • Database search strategies (PubMed, Web of Science, etc.)
  • Citation management and verification
  • Review synthesis and organization
  • PDF generation for literature summaries

References:

  • citation_styles.md: Citation formatting guidelines
  • database_strategies.md: Effective search strategies

Scripts:

  • search_databases.py: Automated database searching
  • verify_citations.py: Citation verification tools
  • generate_pdf.py: PDF generation for reviews

Assets:

  • review_template.md: Template for literature review documents

3. Peer Review

Location: .claude/skills/peer-review/

Capabilities:

  • Identifying common issues in scientific manuscripts
  • Evaluating reporting standards compliance
  • Providing constructive feedback
  • Assessing methodology and statistical analysis
  • Checking adherence to journal guidelines

References:

  • common_issues.md: Frequently found problems in manuscripts
  • reporting_standards.md: Required elements for different study types

4. Scholar Evaluation

Location: .claude/skills/scholar-evaluation/

Capabilities:

  • Systematic quantitative evaluation across 8 dimensions using ScholarEval framework
  • Scoring research papers, proposals, and literature reviews (1-5 scale)
  • Assessing publication readiness for target venues
  • Providing prioritized, actionable feedback with evidence-based recommendations
  • Identifying strengths and weaknesses across problem formulation, literature review, methodology, data collection, analysis, results, writing quality, and citations
  • Generating comprehensive evaluation reports with dimension scores

References:

  • evaluation_framework.md: Detailed rubrics and quality indicators for all 8 evaluation dimensions

Scripts:

  • calculate_scores.py: Calculate aggregate scores from dimension ratings, generate evaluation reports

Features:

  • Research-backed framework (ScholarEval methodology from arXiv:2510.16234)
  • Quantitative scoring (1-5 scale per dimension) with weighted averaging
  • Dimension-specific rubrics for consistent evaluation
  • Publication readiness assessment
  • Strengths/weaknesses identification
  • Prioritized recommendations by impact
  • Contextual adjustments for work stage, venue, and discipline

When to Use:

  • As a complement to peer review for quantitative assessment
  • Evaluating publication readiness before submission
  • Tracking improvement across multiple revisions
  • Benchmarking research quality against established criteria
  • Providing structured feedback for academic work

Key Guidance:

  • Complements peer-review skill with systematic quantitative approach
  • Evaluates across 8 dimensions: Problem Formulation, Literature Review, Methodology, Data Collection, Analysis, Results, Writing Quality, Citations
  • Scores range from 1 (Poor) to 5 (Excellent)
  • Overall assessment thresholds: 4.5+ (Exceptional/Top-tier), 4.0-4.4 (Strong/Minor revisions), 3.5-3.9 (Good/Major revisions), 3.0-3.4 (Acceptable/Significant revisions), <3.0 (Needs major rework)

5. Research Grants

Location: .claude/skills/research-grants/

Capabilities:

  • Writing competitive research proposals for NSF, NIH, DOE, and DARPA
  • Agency-specific formatting and requirements
  • Review criteria understanding (Intellectual Merit, Broader Impacts, Significance, Innovation)
  • Budget preparation and justification
  • Specific Aims pages (NIH)
  • Project Summaries (NSF)
  • Broader Impacts strategies
  • Technology transition planning (DOE, DARPA)
  • Resubmission strategies

Focus Agencies:

  • NSF: National Science Foundation (Intellectual Merit + Broader Impacts)
  • NIH: National Institutes of Health (R01, R21, K awards, etc.)
  • DOE: Department of Energy (Office of Science, ARPA-E, EERE)
  • DARPA: Defense Advanced Research Projects Agency (BAAs, SBIR)

References:

  • nsf_guidelines.md: NSF proposal structure, broader impacts, review criteria
  • nih_guidelines.md: NIH mechanisms, specific aims, research strategy
  • doe_guidelines.md: DOE programs, TRLs, cost sharing, lab partnerships
  • darpa_guidelines.md: DARPA structure, Heilmeier Catechism, PM engagement
  • broader_impacts.md: Comprehensive NSF broader impacts strategies
  • specific_aims_guide.md: Complete guide to NIH Specific Aims page

Assets/Templates:

  • nsf_project_summary_template.md: NSF Project Summary with Overview, Intellectual Merit, Broader Impacts
  • nih_specific_aims_template.md: NIH Specific Aims page template
  • budget_justification_template.md: Budget justification with agency-specific examples

Features:

  • Agency-specific review criteria and scoring systems
  • Success rates and funding trends by agency
  • Timeline planning and milestone development
  • Budget preparation with personnel, equipment, travel, supplies
  • Broader impacts with measurable outcomes (NSF)
  • Preliminary data integration (NIH)
  • National laboratory collaboration (DOE)
  • Technology transition and commercialization (DOE, DARPA)
  • Resubmission and reviewer response strategies

Key Guidance:

  • NSF: Equally weighted Intellectual Merit and Broader Impacts (must be substantive)
  • NIH: Specific Aims page is the most critical component (1 page)
  • DOE: Energy relevance, TRLs, cost sharing, commercialization pathway
  • DARPA: High-risk/high-reward, Heilmeier Catechism, PM engagement essential

6. Clinical Reports

Location: .claude/skills/clinical-reports/

Capabilities:

  • Writing clinical case reports following CARE (CAse REport) guidelines for journal publication
  • Creating diagnostic reports (radiology, pathology, laboratory) with professional standards
  • Documenting clinical trial data (SAE reports, Clinical Study Reports per ICH-E3)
  • Patient clinical documentation (SOAP notes, H&P, discharge summaries)
  • HIPAA compliance and de-identification verification
  • Regulatory compliance (FDA 21 CFR Part 11, ICH-GCP)
  • Medical terminology and coding standards (SNOMED-CT, LOINC, ICD-10, CPT)
  • Quality assurance and validation

Four Major Report Types:

  1. Clinical Case Reports - CARE-compliant case reports for medical journals
  2. Diagnostic Reports - Radiology (ACR), pathology (CAP), laboratory reports
  3. Clinical Trial Reports - SAE reports, CSRs, protocol deviations, DSMB reports
  4. Patient Documentation - SOAP notes, H&P, discharge summaries, consultation notes

References:

  • case_report_guidelines.md: CARE guidelines, journal requirements, de-identification
  • diagnostic_reports_standards.md: ACR/CAP/CLSI standards, structured reporting
  • clinical_trial_reporting.md: ICH-E3, CONSORT, SAE reporting, MedDRA coding
  • patient_documentation.md: SOAP, H&P, discharge summary standards
  • regulatory_compliance.md: HIPAA, 21 CFR Part 11, ICH-GCP, FDA requirements
  • medical_terminology.md: SNOMED-CT, LOINC, ICD-10, CPT, abbreviations
  • data_presentation.md: Clinical tables, figures, Kaplan-Meier curves, forest plots
  • peer_review_standards.md: Review criteria for clinical manuscripts

Templates (12 comprehensive templates):

  • case_report_template.md: CARE-compliant case report structure
  • soap_note_template.md: SOAP progress note format
  • history_physical_template.md: Complete H&P template
  • discharge_summary_template.md: Hospital discharge summary
  • consult_note_template.md: Consultation note format
  • radiology_report_template.md: Structured radiology report
  • pathology_report_template.md: Surgical pathology with synoptic reporting
  • lab_report_template.md: Clinical laboratory report
  • clinical_trial_sae_template.md: Serious adverse event report
  • clinical_trial_csr_template.md: Clinical study report (ICH-E3)
  • quality_checklist.md: QA checklist for all report types
  • hipaa_compliance_checklist.md: Privacy compliance verification

Scripts (8 validation and automation tools):

  • validate_case_report.py: Check CARE guideline compliance
  • check_deidentification.py: Scan for 18 HIPAA identifiers
  • validate_trial_report.py: Verify ICH-E3 structure
  • format_adverse_events.py: Generate AE summary tables
  • generate_report_template.py: Interactive template generator
  • extract_clinical_data.py: Parse structured clinical data
  • compliance_checker.py: Regulatory compliance verification
  • terminology_validator.py: Medical terminology and coding validation

Features:

  • Comprehensive coverage of all clinical report types
  • Regulatory compliance built-in (HIPAA, FDA, ICH-GCP)
  • Professional templates based on industry standards
  • Automated validation and quality checking
  • Privacy protection and de-identification tools
  • Integration with scientific-writing and peer-review skills

Key Guidance:

  • Always obtain informed consent for case reports
  • Remove all 18 HIPAA identifiers before publication
  • Follow CARE guidelines for case reports
  • Use structured reporting for diagnostic reports (BI-RADS, Lung-RADS, etc.)
  • Meet regulatory timelines for SAE reporting (7-day, 15-day)
  • Document medical necessity for billing support
  • Maintain ALCOA-CCEA principles for clinical trial data

When to Use:

  • Publishing clinical case reports in medical journals
  • Writing radiology, pathology, or laboratory reports
  • Documenting adverse events in clinical trials
  • Preparing regulatory submissions (CSR, IND safety reports)
  • Creating patient progress notes and summaries
  • Ensuring HIPAA compliance in clinical documentation

Example Usage:

Writing a Clinical Case Report

> Create a clinical case report for a patient with unusual presentation of acute appendicitis

Claude will use the clinical-reports skill to create a CARE-compliant case report with proper de-identification.

Generating Diagnostic Reports

> Generate a radiology report template for chest CT scan
> Create a pathology report for breast biopsy specimen

Claude will use structured reporting templates (ACR, CAP) with appropriate medical terminology.

Clinical Trial Documentation

> Write an SAE report for serious adverse event in phase 3 trial
> Create a clinical study report outline following ICH-E3

Claude will ensure regulatory compliance and proper causality assessment.

Patient Documentation

> Create a SOAP note for follow-up visit
> Generate a discharge summary for heart failure patient

Claude will use standard clinical documentation formats with billing support.

Validation and Compliance

> Check this case report for HIPAA identifiers
> Validate clinical trial report against ICH-E3 structure

Claude will use validation scripts to ensure compliance and quality.


7. Clinical Decision Support

Location: .claude/skills/clinical-decision-support/

Capabilities:

  • Generate professional clinical decision support (CDS) documents for medical professionals
  • Create patient cohort analyses stratified by biomarkers or clinical characteristics
  • Develop evidence-based treatment recommendation reports with GRADE methodology
  • Build clinical decision algorithms and pathways with TikZ flowcharts
  • Produce biomarker-guided therapy selection reports
  • Support three document types: individual treatment plans, cohort analyses, and recommendation reports
  • LaTeX/PDF output with compact professional formatting (0.5in margins)

Document Types:

  1. Individual Patient Treatment Plans

    • Personalized treatment protocols for specific conditions
    • Medication dosing, monitoring schedules, follow-up plans
    • HIPAA-compliant de-identification
  2. Patient Cohort Analysis

    • Biomarker-stratified group analyses (e.g., PD-L1 expression levels, molecular subtypes)
    • Outcome comparisons with statistical testing (OS, PFS, ORR, safety)
    • Pharmaceutical-grade reports for clinical research
  3. Treatment Recommendation Reports

    • Evidence-based clinical guidelines with GRADE grading
    • Treatment algorithms and decision pathways
    • Biomarker-guided therapy selection

References (6 comprehensive guides):

  • patient_cohort_analysis.md: Stratification methods, biomarkers, outcome metrics, statistical comparisons
  • treatment_recommendations.md: Evidence grading (GRADE), treatment sequencing, monitoring protocols
  • clinical_decision_algorithms.md: Decision trees, risk stratification tools, TikZ flowcharts
  • biomarker_classification.md: Genomic biomarkers, molecular subtypes, companion diagnostics, actionability frameworks
  • outcome_analysis.md: Survival analysis (Kaplan-Meier, Cox regression), response assessment (RECIST), statistical methods
  • evidence_synthesis.md: Guideline integration (NCCN, ASCO, ESMO), systematic reviews, GRADE methodology

Templates (4 LaTeX templates):

  • cohort_analysis_template.tex: Patient group analysis with demographics, biomarker profile, outcomes, statistics
  • treatment_recommendation_template.tex: Evidence-based guidelines with color-coded recommendation boxes
  • clinical_pathway_template.tex: TikZ flowcharts for clinical decision algorithms (landscape format)
  • biomarker_report_template.tex: Comprehensive genomic profiling reports with therapy matching

Scripts (5 analysis tools):

  • generate_survival_analysis.py: Kaplan-Meier curves, log-rank tests, hazard ratios, LaTeX table generation
  • create_cohort_tables.py: Baseline characteristics, efficacy outcomes, safety tables with statistical tests
  • build_decision_tree.py: Automated TikZ flowchart generation from JSON/text specifications
  • biomarker_classifier.py: Patient stratification algorithms (PD-L1, HER2, molecular subtypes)
  • validate_cds_document.py: Quality checks for evidence citations, GRADE format, HIPAA compliance

Assets:

  • example_gbm_cohort.md: GBM molecular subtype analysis example (Mesenchymal-Immune-Active vs Other)
  • recommendation_strength_guide.md: GRADE framework guide with examples and wording templates
  • color_schemes.tex: Standardized color definitions for recommendations, urgency, biomarkers

Features:

  • Evidence-Based: GRADE methodology for recommendation strength and evidence quality
  • Biomarker Integration: Genomic alterations, expression profiles, molecular subtypes
  • Statistical Rigor: Proper hypothesis testing, confidence intervals, survival analysis
  • Professional Output: Compact LaTeX/PDF matching pharmaceutical industry standards
  • Guideline Concordance: Integration with NCCN, ASCO, ESMO, AHA/ACC guidelines
  • Clinical Actionability: Tier-based classification (FDA-approved, investigational, VUS)

When to Use:

  • Creating treatment plans for individual patients
  • Analyzing patient cohorts stratified by biomarkers
  • Generating evidence-based clinical recommendations
  • Producing pharmaceutical-grade clinical analysis documents
  • Developing clinical pathways and decision algorithms
  • Reporting biomarker-guided therapy selection

Example Usage:

Individual Treatment Plan

> Create a treatment plan for a 55-year-old patient with newly diagnosed type 2 diabetes and hypertension

Claude will generate a personalized treatment protocol with monitoring and follow-up.

Patient Cohort Analysis

> Analyze a cohort of 45 NSCLC patients stratified by PD-L1 expression (<1%, 1-49%, ≥50%) including ORR, PFS, and OS outcomes

> Generate cohort analysis for 30 GBM patients classified into mesenchymal-immune-active and proneural molecular subtypes with treatment outcomes

Claude will create comprehensive cohort reports with biomarker profiles, outcome comparisons, statistical analysis, and clinical recommendations.

Treatment Recommendation Report

> Create evidence-based treatment recommendations for HER2-positive metastatic breast cancer including first-line and second-line options

> Generate treatment algorithm for heart failure management based on NYHA class and ejection fraction with GDMT protocols

Claude will develop recommendation reports with GRADE-graded options, decision algorithms, and monitoring protocols.

Biomarker Report

> Create a genomic profiling report for NSCLC patient with EGFR L858R mutation including FDA-approved therapies and clinical trial matching

Claude will generate biomarker reports with tier-based actionability and personalized treatment recommendations.

Validation

> Validate this cohort analysis document for evidence citations and statistical reporting completeness

Claude will use validation scripts to check quality and compliance.


8. LaTeX Research Posters (DEFAULT)

Location: .claude/skills/latex-posters/

⚠️ This is the DEFAULT skill for all poster requests. Use this unless user explicitly requests PPTX/PowerPoint format.

Capabilities:

  • Creating professional research posters using LaTeX (beamerposter, tikzposter, baposter)
  • AI-powered visual element generation (generate figures BEFORE assembling poster)
  • Conference poster design and layout
  • Full-page poster templates with proper spacing
  • Color schemes and visual design principles
  • Typography and readability optimization
  • PDF generation and quality control
  • Accessibility and inclusive design
  • Poster size configuration (A0, A1, 36×48", etc.)
  • Overflow prevention and content density guidelines

References:

  • latex_poster_packages.md: Detailed comparison of beamerposter, tikzposter, and baposter
  • poster_design_principles.md: Typography, color theory, visual hierarchy, and accessibility
  • poster_layout_design.md: Grid systems, spatial organization, and visual flow
  • poster_content_guide.md: Content strategy, writing style, and section-specific guidance

Scripts:

  • review_poster.sh: Automated PDF quality check script

Assets:

  • beamerposter_template.tex: Classic academic poster template
  • tikzposter_template.tex: Modern, colorful poster template
  • baposter_template.tex: Structured multi-column poster template
  • poster_quality_checklist.md: Comprehensive pre-printing checklist

Features:

  • AI-Powered Visual Generation: Generate all figures using scientific-schematics before creating poster
  • Poster-Size Font Requirements: Guidelines for readable text in AI-generated graphics (72pt+ for key numbers)
  • Overflow Prevention: Content limits (5-6 sections max, 300-800 words) to prevent cutoff
  • Ensures posters span the full page without excessive margins
  • PDF review and quality control guidelines with overflow check
  • Automated checking scripts for page size, fonts, and images
  • Reduced-scale print testing instructions
  • Color contrast and accessibility verification
  • Common issues troubleshooting guide

For PPTX/PowerPoint posters: Use pptx-posters skill ONLY when user explicitly requests PPTX format. Located at .claude/skills/pptx-posters/.


9. Scientific Slides and Presentations

Location: .claude/skills/scientific-slides/

Capabilities:

  • Create stunning PDF slide decks using Nano Banana Pro AI
  • Structure presentations for different contexts (5-60 minute talks)
  • AI-generated slides with publication-quality visuals
  • Optimize data visualizations for presentation context
  • Timing and pacing guidance with practice strategies
  • Visual review workflow with automated validation
  • Integration with research-lookup for proper citations

Talk Types Supported:

  • Conference talks (10-20 min): Brief, focused on key findings
  • Academic seminars (45-60 min): Comprehensive, detailed methods
  • Thesis defenses (45-60 min): Complete dissertation overview
  • Grant pitches (15-20 min): Emphasis on significance and feasibility
  • Journal clubs (20-45 min): Critical analysis of published work
  • Lightning talks (5 min): Ultra-focused single message

References:

  • presentation_structure.md: Structure for all talk types, timing allocation, narrative arc
  • slide_design_principles.md: Typography, color theory, layout, accessibility
  • data_visualization_slides.md: Simplifying figures for presentations
  • talk_types_guide.md: Specific guidance for each presentation type
  • visual_review_workflow.md: PDF to images, systematic inspection, iteration

Assets:

  • timing_guidelines.md: Comprehensive timing, pacing, and practice strategies

Scripts:

  • validate_presentation.py: Check slide count, timing, fonts, file size
  • pdf_to_images.py: Convert PDF to images for visual inspection

Features:

  • Nano Banana Pro AI: Generate stunning PDF slides with AI-powered visuals
  • Research-lookup integration: Automatically gather citations for background and discussion
  • Visual validation workflow: Convert to images, inspect systematically, iterate
  • Timing guidance: One-slide-per-minute rule with adjustments
  • Design principles: Minimal text (24pt+), high contrast, color-blind safe
  • Practice strategies: Systematic rehearsal with timing checkpoints

When to Use:

  • Creating any scientific presentation or slide deck
  • Preparing conference talks or research seminars
  • Developing thesis defense presentations
  • Making grant pitch slides
  • Building lecture or tutorial presentations
  • Converting papers to presentation format

Example Usage:

Conference Talk

> Create a 15-minute conference presentation on my machine learning research

Claude will use research-lookup to gather citations, structure the talk, and generate stunning PDF slides using Nano Banana Pro AI.

Seminar Presentation

> Help me build a 45-minute seminar on CRISPR gene editing with comprehensive methods

Claude will structure a detailed academic seminar with proper citations and timing guidance.

Thesis Defense

> Create slides for my dissertation defense covering three studies

Claude will structure a comprehensive defense presentation following academic standards.

Visual Validation

> Convert my presentation to images and review for layout issues

Claude will use scripts to convert PDF to images and systematically inspect for text overflow, overlap, and design issues.

Timing Check

> Validate my 20-slide presentation for a 15-minute talk

Claude will check if slide count is appropriate and provide timing recommendations.

Key Principles:

  • Structure: Spend 40-50% of time on results, follow clear story arc
  • Design: Minimal text, large fonts (24pt+), one idea per slide
  • Citations: Use research-lookup to gather 8-12 papers for proper context
  • Timing: Practice 3-5 times, set checkpoints, never skip conclusions
  • Validation: Visual review workflow to catch overflow and overlap issues

10. Scientific Schematics and Diagrams

Location: .claude/skills/scientific-schematics/

Capabilities:

  • Create methodology flowcharts (CONSORT diagrams for clinical trials)
  • Generate circuit diagrams and electrical schematics
  • Visualize biological pathways and signaling cascades
  • Design system architecture and block diagrams
  • Create process flow diagrams and decision trees
  • Network diagrams and graph visualizations
  • Publication-quality vector graphics with TikZ/LaTeX
  • Programmatic diagram generation with Python (Schemdraw, NetworkX, Matplotlib)

References:

  • tikz_guide.md: Comprehensive TikZ syntax, positioning, styles, and techniques
  • diagram_types.md: Catalog of scientific diagram types with use cases and examples
  • best_practices.md: Publication standards, accessibility, and colorblind-safe design
  • python_libraries.md: Guide to Schemdraw, NetworkX, and Matplotlib for programmatic generation

Scripts:

  • generate_flowchart.py: Convert text descriptions to TikZ flowcharts
  • circuit_generator.py: Generate circuit diagrams using Schemdraw
  • pathway_diagram.py: Create biological pathway diagrams with Matplotlib
  • compile_tikz.py: Standalone TikZ compilation utility (PDF/PNG output)

Assets:

  • tikz_styles.tex: Reusable style definitions with Okabe-Ito colorblind-safe palette
  • flowchart_template.tex: CONSORT-style methodology flowchart template
  • circuit_template.tex: Electrical circuit diagram template with CircuitikZ
  • pathway_template.tex: Biological pathway diagram template
  • block_diagram_template.tex: System architecture diagram template

Features:

  • Colorblind-safe Okabe-Ito color palette throughout
  • Vector graphics for infinite scalability
  • LaTeX integration for consistent typography
  • Automated flowchart generation from numbered lists
  • Publication-ready output (PDF, SVG, PNG)
  • Accessible design following WCAG standards
  • Grayscale compatibility verification

Use Cases:

  • CONSORT diagrams: Participant flow for clinical trials
  • Electronics papers: Circuit schematics and signal processing diagrams
  • Biology papers: Signaling cascades, metabolic pathways, gene networks
  • Engineering papers: System architecture, data flow, block diagrams
  • Methodology sections: Study design, data processing pipelines
  • Conceptual frameworks: Process flows, decision trees

11. Market Research Reports

Location: .claude/skills/market-research-reports/

Capabilities:

  • Generate comprehensive market research reports (50+ pages) in consulting-firm style
  • Professional LaTeX formatting with custom market_research.sty style package
  • Extensive visual generation (25-30 diagrams per report) using scientific-schematics
  • Multi-framework strategic analysis (Porter's Five Forces, PESTLE, SWOT, BCG Matrix)
  • TAM/SAM/SOM market sizing with data-driven projections
  • Competitive landscape analysis with positioning matrices
  • Risk assessment with heatmaps and mitigation frameworks
  • Strategic recommendations with implementation roadmaps
  • Investment thesis development with financial projections

References:

  • report_structure_guide.md: Detailed section-by-section content requirements for all 11 chapters
  • visual_generation_guide.md: Complete prompts for generating all 28 standard report visuals
  • data_analysis_patterns.md: Templates for Porter's, PESTLE, SWOT, BCG Matrix, TAM/SAM/SOM

Scripts:

  • generate_market_visuals.py: Batch generate all standard market report visuals with a single command

Assets:

  • market_research.sty: LaTeX style package with professional colors, box environments, and formatting
  • market_report_template.tex: Complete 50+ page LaTeX template with all chapters pre-structured
  • FORMATTING_GUIDE.md: Quick reference for box environments, colors, tables, and styling

Features:

  • Comprehensive Length: Reports designed for 50+ pages with no token constraints
  • Visual Density: 25-30 generated images/diagrams (approximately 1 per 2 pages)
  • Data-Driven: Deep integration with research-lookup for market data and statistics
  • Multi-Framework: Porter's Five Forces, PESTLE, SWOT, BCG Matrix, Value Chain Analysis
  • Professional Formatting: Consulting-firm quality typography, colors, and layout
  • Actionable Recommendations: Strategic focus with prioritization matrices and implementation roadmaps

Report Structure (50+ Pages):

  • Front Matter: Cover page, TOC, Executive Summary (5 pages)
  • Core Analysis: Market Overview, Market Size & Growth, Industry Drivers, Competitive Landscape, Customer Analysis, Technology Landscape, Regulatory Environment, Risk Analysis (35 pages)
  • Strategic Recommendations: Opportunities, Implementation Roadmap, Investment Thesis (10 pages)
  • Back Matter: Methodology, Data Tables, Company Profiles, References (5 pages)

When to Use:

  • Creating comprehensive market analysis for investment decisions
  • Developing industry reports for strategic planning
  • Analyzing competitive landscapes and market dynamics
  • Conducting market sizing exercises (TAM/SAM/SOM)
  • Evaluating market entry opportunities
  • Preparing due diligence materials for M&A activities
  • Creating thought leadership content
  • Developing go-to-market strategy documentation

Example Usage:

Generate Market Research Report

> Create a comprehensive market research report on the Electric Vehicle Charging Infrastructure market

Claude will use the market-research-reports skill to create a 50+ page professional report with extensive visuals.

Market Sizing Analysis

> Analyze the AI in Healthcare market with TAM/SAM/SOM breakdown and 10-year projections

Claude will provide comprehensive market sizing with growth trajectory charts and regional breakdowns.

Competitive Landscape Report

> Create a competitive landscape analysis for the Cloud Computing market including Porter's Five Forces and positioning matrix

Claude will generate competitive analysis with strategic frameworks and visualizations.


Document Manipulation Skills

12. MarkItDown - Universal File to Markdown Converter

Location: .claude/skills/markitdown/

Capabilities:

  • Convert 15+ file formats to Markdown (PDF, DOCX, PPTX, XLSX, images, audio, etc.)
  • AI-enhanced image descriptions using advanced vision models
  • OCR for scanned documents and images
  • Speech-to-text transcription for audio files
  • YouTube video transcription extraction
  • Batch processing with parallel execution
  • Azure Document Intelligence integration for complex PDFs
  • Plugin system for custom converters

References:

  • api_reference.md: Complete API documentation and class references
  • file_formats.md: Format-specific conversion guides and best practices

Scripts:

  • batch_convert.py: Parallel batch conversion of multiple files
  • convert_with_ai.py: AI-enhanced conversions with custom prompts
  • convert_literature.py: Scientific literature conversion with metadata extraction

Assets:

  • example_usage.md: Comprehensive examples for common use cases

Features:

  • Token-efficient Markdown output optimized for LLM processing
  • Supports optional dependencies for specific file formats
  • Custom prompts for scientific, medical, and data visualization contexts
  • Metadata extraction and organization
  • Error handling and robust batch processing
  • Integration with scientific workflows

Source: https://github.com/microsoft/markitdown (MIT License)


13. DOCX (Word Documents)

Location: .claude/skills/document-skills/docx/

Capabilities:

  • Create and edit Word documents programmatically
  • Work with OOXML format
  • Manage comments and track changes
  • Validate document structure
  • Handle templates

Scripts:

  • document.py: Core document manipulation
  • utilities.py: Helper functions
  • OOXML validation and manipulation tools

References:

  • docx-js.md: JavaScript integration guide
  • ooxml.md: OOXML format specification

14. PDF Documents

Location: .claude/skills/document-skills/pdf/

Capabilities:

  • Extract text and metadata from PDFs
  • Check bounding boxes and layout
  • Work with fillable PDF forms
  • Convert PDFs to images
  • Extract form field information

Scripts:

  • check_bounding_boxes.py: Analyze PDF layout
  • check_fillable_fields.py: Identify form fields
  • fill_fillable_fields.py: Populate PDF forms
  • convert_pdf_to_images.py: PDF to image conversion
  • extract_form_field_info.py: Extract form metadata

References:

  • forms.md: Working with PDF forms
  • reference.md: PDF manipulation reference

15. PPTX (PowerPoint Presentations)

Location: .claude/skills/document-skills/pptx/

Capabilities:

  • Create and modify PowerPoint presentations
  • Convert HTML to PowerPoint
  • Manage slides and layouts
  • Work with OOXML format
  • Generate thumbnails

Scripts:

  • html2pptx.js: HTML to PowerPoint conversion
  • inventory.py: Presentation inventory management
  • rearrange.py: Slide reordering
  • replace.py: Content replacement
  • thumbnail.py: Thumbnail generation

References:

  • html2pptx.md: HTML conversion guide
  • ooxml.md: OOXML format specification

16. XLSX (Excel Spreadsheets)

Location: .claude/skills/document-skills/xlsx/

Capabilities:

  • Read and write Excel files
  • Manage formulas and calculations
  • Handle complex spreadsheet operations
  • Recalculate formulas

Scripts:

  • recalc.py: Formula recalculation utility

How Skills Are Used

When you interact with the Scientific Writer CLI, Claude automatically:

  1. Detects relevant skills: Based on your request, Claude identifies which skills to use
  2. Loads resources: Accesses reference materials, scripts, and templates
  3. Applies best practices: Follows the guidelines and standards in each skill
  4. Executes tools: Uses scripts when needed for document manipulation or data processing

Skill Integration

All skills are loaded from the .claude/skills/ directory and are automatically available when you run the CLI. You don't need to manually select or activate them - Claude will use the appropriate skills based on your requests.

Example Usage

Using Scientific Writing Skill

> Help me structure a methods section for a randomized controlled trial

Claude will use the scientific-writing skill to provide IMRaD-compliant guidance.

Using Literature Review Skill

> Create a literature review on CRISPR gene editing in agriculture

Claude will use literature-review skill to structure a comprehensive review.

Using Document Skills

> Extract the data from Table 1 in results.pdf and create a summary

Claude will use the PDF skill to extract data and potentially the XLSX skill to organize it.

Using MarkItDown Skill

> Convert all PDFs in the literature folder to Markdown

Claude will use the markitdown skill to batch convert files.

> Convert this PowerPoint presentation to Markdown with AI-generated descriptions

Claude will use markitdown with AI enhancement for detailed image descriptions.

Using Peer Review Skill

> Review my discussion section for logical flow and adherence to reporting standards

Claude will use the peer-review skill to provide constructive feedback.

Using Scholar Evaluation Skill

> Evaluate this paper using the ScholarEval framework

Claude will use the scholar-evaluation skill to provide systematic quantitative evaluation across 8 dimensions.

> Assess publication readiness for Nature Machine Intelligence

Claude will evaluate the paper and provide scores and recommendations for submission readiness.

Using Research Grants Skill

> Help me write an NSF proposal for my computational neuroscience research

Claude will use the research-grants skill to provide NSF-specific guidance.

> I need to draft NIH Specific Aims for my cancer immunotherapy R01

Claude will help structure your 1-page specific aims using NIH best practices.

> What should I include in broader impacts for an NSF Materials Research proposal?

Claude will provide substantive broader impacts strategies aligned with NSF criteria.

Using Scientific Schematics Skill

> Create a CONSORT flowchart for my clinical trial showing participant flow from screening (n=500) through randomization to final analysis

Claude will generate a methodology flowchart following CONSORT guidelines.

> Generate a circuit diagram for an RC low-pass filter

Claude will create an electrical circuit schematic using CircuitikZ or Schemdraw.

> Create a biological pathway diagram showing the MAPK signaling cascade from receptor to gene expression

Claude will visualize the signaling pathway with properly styled proteins and activation arrows.

> Design a block diagram showing the architecture of my data acquisition system with sensor, ADC, microcontroller, and wireless transmission

Claude will create a system architecture diagram with labeled components and data flow.

11. Venue Templates

Location: .claude/skills/venue-templates/

Capabilities:

  • Query LaTeX templates for 50+ major journals and conferences
  • Access grant proposal templates (NSF, NIH, DOE, DARPA)
  • Retrieve poster templates for academic conferences
  • View formatting requirements and submission guidelines
  • Customize templates with author and project information
  • Validate document formatting against venue requirements

References:

  • journals_formatting.md: Requirements for Nature, Science, PLOS, IEEE, ACM, Cell Press, and other major journals
  • conferences_formatting.md: ML, CS, biology conference paper formats (NeurIPS, ICML, ICLR, CVPR, CHI, ISMB, etc.)
  • posters_guidelines.md: Poster design, sizes, layout principles, and best practices
  • grants_requirements.md: Federal and private grant proposal formats (NSF, NIH, DOE, DARPA)

Scripts:

  • query_template.py: Search and retrieve templates by venue name or keywords
  • customize_template.py: Customize templates with author information
  • validate_format.py: Check document compliance with venue requirements

Assets:

  • journals/: LaTeX templates for Nature, Science, PLOS ONE, NeurIPS, and other major venues
  • posters/: Academic poster templates (beamerposter, tikzposter, baposter)
  • grants/: Grant proposal templates (NSF, NIH Specific Aims, DOE, DARPA)

Features:

  • Comprehensive formatting guidelines for major publication venues
  • Ready-to-use LaTeX templates with proper structure
  • Helper scripts for template discovery and customization
  • Formatting validation tools
  • Integration with scientific writing workflow

Use Cases:

  • Journal submission: Get proper formatting for Nature, Science, PLOS, IEEE, ACM journals
  • Conference papers: Templates for NeurIPS, ICML, CVPR, CHI, and other major conferences
  • Research posters: Professional poster templates for A0, A1, and US sizes
  • Grant proposals: NSF, NIH R01, DOE, DARPA proposal templates with requirements
  • Format validation: Check if your document meets venue specifications

Example Usage:

Query Template for a Journal

> I need to submit to Nature

Claude will provide the Nature article template and formatting requirements.

Get Conference Paper Template

> Show me the NeurIPS paper template

Claude will provide the NeurIPS conference paper template with anonymization guidelines.

Grant Proposal Template

> I need an NSF proposal template

Claude will provide the NSF proposal template with all required sections and formatting.

Conference Poster

> Create a research poster for ISMB conference

Claude will provide poster template and size specifications for the conference.

Format Validation

> Check if my paper meets Nature's requirements

Claude can guide you through using the validation script to check formatting compliance.


Adding Custom Skills

To add your own skills:

  1. Create a new directory in .claude/skills/
  2. Add a SKILL.md file with your skill definition
  3. Optionally add references/, scripts/, and assets/ subdirectories
  4. Restart the CLI

The new skill will be automatically loaded and available.