Skip to content
Back to search

claude-scientific-writer

SkillWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/k-dense-ai--claude-scientific-writer/badge.svg)](/listings/k-dense-ai--claude-scientific-writer)

HTML

<a href="/listings/k-dense-ai--claude-scientific-writer"><img src="/api/listings/k-dense-ai--claude-scientific-writer/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

- Python 3.10 or newer - ANTHROPIC_API_KEY (required) - Parallel CLI authentication (`parallel-cli login`) or `PARALLEL_API_KEY` - OPENROUTER_API_KEY (optional, for AI image generation: schematics, figures, slides, and infographics) - A LaTeX distribution for PDF generation (`pdflatex`, `bibtex`, and preferably `latexmk`) - Optional: LibreOffice for Office rendering/recalculation and FFmpeg for media conversion

Installation Options

Option 1: Claude Code Plugin (Recommended) ⭐

The easiest way to use Scientific Writer is as a Claude Code plugin. See the [Plugin Installation](#-use-as-a-claude-code-plugin-recommended) section below.

Option 2: Install from PyPI (CLI/API Usage)

pip install scientific-writer

# Optional bundled-script runtimes
pip install "scientific-writer[analysis]"  # cohort statistics and survival analysis
pip install "scientific-writer[office]"    # DOCX/PPTX/XLSX and MarkItDown helpers

Option 3: Install from source with uv

git clone https://github.com/K-Dense-AI/claude-scientific-writer.git
cd claude-scientific-writer
uv sync

Configure API keys

# .env file (recommended) — see .env.example for the full list
echo "ANTHROPIC_API_KEY=your_key" > .env
echo "PARALLEL_API_KEY=your_parallel_key" >> .env            # research lookup and web search
echo "OPENROUTER_API_KEY=your_openrouter_key" >> .env        # optional: AI image generation
# or export in your shell
export ANTHROPIC_API_KEY='your_key'

Install and authenticate the research CLI when it is not already available:

uv tool install "parallel-web-tools[cli]==0.7.1"
parallel-cli login
parallel-cli auth

Usage Options

Use as Plugin (Recommended)

After installing the plugin and running `/claude-scientific-writer:scientific-writer-init`, simply ask Claude:

> Create a Nature paper on CRISPR gene editing. Present experimental_data.csv 
  (efficiency across 5 cell lines), include Western_blot.png and flow_cytometry.png 
  showing 87% editing efficiency (p<0.001). Compare with literature benchmarks.

> Generate an NSF grant proposal presenting preliminary data from quantum_results.csv 
  (99.2% gate fidelity), circuit_topology.png, and error_rates.csv. 
  Include 5-year timeline with milestones_budget.xlsx.

> @research-lookup Find papers on mRNA vaccine efficacy (2022-2024). Compare 
  with our trial_outcomes.csv (n=500, 94% efficacy) and antibody_titers.png.

Use the CLI

# If installed via pip
scientific-writer
scientific-writer --effort high

# If installed from source with uv
uv run scientific-writer

Use `scientific-writer --help` for permission, budget, token-usage, and input-consumption controls. Input files are preserved by default; `--consume-inputs` explicitly removes them after a successful copy.

Use the Python API

import asyncio
from scientific_writer import generate_paper

async def main():
    # Detailed prompt with specific data and figures
    async for update in generate_paper(
        query=(
            "Create a Nature paper on CRISPR gene editing. "
            "Present editing_efficiency.csv (5 cell lines, n=200 cells each). "
            "Include Western blot (protein_knockout.png) showing target depletion, "
            "flow cytometry data (editing_percentages.png) with 87% efficiency in HEK293, "
            "and off_target_analysis.csv showing <0.1% off-target effects. "
            "Compare results to published Cas9 benchmarks (typically 70-75% efficiency)."
        ),
        data_files=[
            "editing_efficiency.csv",
            "protein_knockout.png",
            "editing_percentages.png",
            "off_target_analysis.csv"
        ]
    ):
        if update["type"] == "text":
            print(update["content"], end="", flush=True)
        elif update["type"] == "progress":
            print(f"[{update['stage']}] {update['message']}")
        elif update["type"] == "result":

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 48 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "claude-scientific-writer",
  3. "metadata": {
  4. "description": "Skills and setup for scientific writing (papers, grants, posters, clinical reports) using the scientific-writer toolkit.",
  5. "version": "2.23.0",
  6. "homepage": "https://github.com/K-Dense-AI/claude-scientific-writer"
  7. },
  8. "owner": {
  9. "name": "K-Dense Inc.",
  10. "email": "contact@k-dense.ai"
  11. },
  12. "plugins": [
  13. {
  14. "name": "claude-scientific-writer",
  15. "description": "Collection of scientific writer skills",
  16. "source": "./",
  17. "strict": false,
  18. "skills": [
  19. "./skills/citation-management",
  20. "./skills/clinical-decision-support",
  21. "./skills/clinical-reports",
  22. "./skills/docx",
  23. "./skills/generate-image",
  24. "./skills/hypothesis-generation",
  25. "./skills/infographics",
  26. "./skills/latex-posters",
  27. "./skills/literature-review",
  28. "./skills/market-research-reports",
  29. "./skills/markitdown",
  30. "./skills/parallel-web",
  31. "./skills/pdf",
  32. "./skills/peer-review",
  33. "./skills/pptx",
  34. "./skills/pptx-posters",
  35. "./skills/research-grants",
  36. "./skills/research-lookup",
  37. "./skills/scholar-evaluation",
  38. "./skills/scientific-critical-thinking",
  39. "./skills/scientific-schematics",
  40. "./skills/scientific-slides",
  41. "./skills/scientific-writing",
  42. "./skills/treatment-plans",
  43. "./skills/venue-templates",
  44. "./skills/xlsx"
  45. ]
  46. }
  47. ]
  48. }
README.md · README · 517 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Claude Scientific Writer
  2. [![PyPI version](https://img.shields.io/pypi/v/scientific-writer.svg)](https://pypi.org/project/scientific-writer/)
  3. [![Total Downloads](https://static.pepy.tech/badge/scientific-writer)](https://pepy.tech/project/scientific-writer)
  4. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  5. [![X](https://img.shields.io/badge/Follow_on_X-%40k__dense__ai-000000?logo=x)](https://x.com/k_dense_ai)
  6. [![LinkedIn](https://img.shields.io/badge/LinkedIn-K--Dense_Inc.-0A66C2?logo=linkedin)](https://www.linkedin.com/company/k-dense-inc)
  7. [![YouTube](https://img.shields.io/badge/YouTube-K--Dense_Inc.-FF0000?logo=youtube)](https://www.youtube.com/@K-Dense-Inc)
  8. [![Reddit](https://img.shields.io/badge/Reddit-u%2F--k--dense---FF4500?logo=reddit&logoColor=white)](https://www.reddit.com/user/-k-dense-/)
  9. [![Blog](https://img.shields.io/badge/Blog-k--dense.ai-1a1a1a)](https://www.k-dense.ai/blog)
  10. > 🚀 **Looking for more advanced capabilities?** For end-to-end scientific writing, deep scientific search, advanced image generation and enterprise solutions, visit **[www.k-dense.ai](https://www.k-dense.ai)**
  11. > **Stay up to date:** Read the [K-Dense blog](https://www.k-dense.ai/blog), and follow us on [X](https://x.com/k_dense_ai), [LinkedIn](https://www.linkedin.com/company/k-dense-inc), and [YouTube](https://www.youtube.com/@K-Dense-Inc) for new features, release announcements, walkthroughs, research workflow demos, and examples you can use with Scientific Writer. See [From the K-Dense Blog](#from-the-k-dense-blog) for posts that map to this tool.
  12. > 🎬 **Prefer to watch first?** [The Open Source, Locally-Hosted Scientific Writer Workflow](https://youtu.be/tsPsbAYfCFI) shows the writer researching and drafting a paper end to end. More walkthroughs on the [K-Dense YouTube channel](https://www.youtube.com/@K-Dense-Inc).
  13. **A deep research and writing tool** that combines the power of AI-driven deep research with well-formatted written outputs. Generate publication-ready scientific papers, reports, posters, grant proposals, literature reviews, and more academic documents—all backed by real-time literature search and verified citations.
  14. Scientific Writer performs comprehensive research before writing, ensuring every claim is supported by real, verifiable sources. Features include real-time research lookup through Parallel Search and Extract, intelligent paper detection, comprehensive document conversion, and AI-powered diagram generation. You can use it as a Claude Code plugin, Python package, or native CLI. The announcement post, [Claude Scientific Writer: Our Open Source Tool for AI-Powered Research Writing](https://www.k-dense.ai/blog/claude-scientific-writer-open-source), covers why we built it and what it produces.
  15. ## Quick Start
  16. ### Prerequisites
  17. - Python 3.10 or newer
  18. - ANTHROPIC_API_KEY (required)
  19. - Parallel CLI authentication (`parallel-cli login`) or `PARALLEL_API_KEY`
  20. - OPENROUTER_API_KEY (optional, for AI image generation: schematics, figures, slides, and infographics)
  21. - A LaTeX distribution for PDF generation (`pdflatex`, `bibtex`, and preferably `latexmk`)
  22. - Optional: LibreOffice for Office rendering/recalculation and FFmpeg for media conversion
  23. ### Installation Options
  24. #### Option 1: Claude Code Plugin (Recommended) ⭐
  25. The easiest way to use Scientific Writer is as a Claude Code plugin. See the [Plugin Installation](#-use-as-a-claude-code-plugin-recommended) section below.
  26. #### Option 2: Install from PyPI (CLI/API Usage)
  27. ```bash
  28. pip install scientific-writer
  29. # Optional bundled-script runtimes
  30. pip install "scientific-writer[analysis]" # cohort statistics and survival analysis
  31. pip install "scientific-writer[office]" # DOCX/PPTX/XLSX and MarkItDown helpers
  32. ```
  33. #### Option 3: Install from source with uv
  34. ```bash
  35. git clone https://github.com/K-Dense-AI/claude-scientific-writer.git
  36. cd claude-scientific-writer
  37. uv sync
  38. ```
  39. ### Configure API keys
  40. ```bash
  41. # .env file (recommended) — see .env.example for the full list
  42. echo "ANTHROPIC_API_KEY=your_key" > .env
  43. echo "PARALLEL_API_KEY=your_parallel_key" >> .env # research lookup and web search
  44. echo "OPENROUTER_API_KEY=your_openrouter_key" >> .env # optional: AI image generation
  45. # or export in your shell
  46. export ANTHROPIC_API_KEY='your_key'
  47. ```
  48. Install and authenticate the research CLI when it is not already available:
  49. ```bash
  50. uv tool install "parallel-web-tools[cli]==0.7.1"
  51. parallel-cli login
  52. parallel-cli auth
  53. ```
  54. ### Usage Options
  55. #### Use as Plugin (Recommended)
  56. After installing the plugin and running `/claude-scientific-writer:scientific-writer-init`, simply ask Claude:
  57. ```bash
  58. > Create a Nature paper on CRISPR gene editing. Present experimental_data.csv
  59. (efficiency across 5 cell lines), include Western_blot.png and flow_cytometry.png
  60. showing 87% editing efficiency (p<0.001). Compare with literature benchmarks.
  61. > Generate an NSF grant proposal presenting preliminary data from quantum_results.csv
  62. (99.2% gate fidelity), circuit_topology.png, and error_rates.csv.
  63. Include 5-year timeline with milestones_budget.xlsx.
  64. > @research-lookup Find papers on mRNA vaccine efficacy (2022-2024). Compare
  65. with our trial_outcomes.csv (n=500, 94% efficacy) and antibody_titers.png.
  66. ```
  67. #### Use the CLI
  68. ```bash
  69. # If installed via pip
  70. scientific-writer
  71. scientific-writer --effort high
  72. # If installed from source with uv
  73. uv run scientific-writer
  74. ```
  75. Use `scientific-writer --help` for permission, budget, token-usage, and input-consumption controls. Input files are preserved by default; `--consume-inputs` explicitly removes them after a successful copy.
  76. #### Use the Python API
  77. ```python
  78. import asyncio
  79. from scientific_writer import generate_paper
  80. async def main():
  81. # Detailed prompt with specific data and figures
  82. async for update in generate_paper(
  83. query=(
  84. "Create a Nature paper on CRISPR gene editing. "
  85. "Present editing_efficiency.csv (5 cell lines, n=200 cells each). "
  86. "Include Western blot (protein_knockout.png) showing target depletion, "
  87. "flow cytometry data (editing_percentages.png) with 87% efficiency in HEK293, "
  88. "and off_target_analysis.csv showing <0.1% off-target effects. "
  89. "Compare results to published Cas9 benchmarks (typically 70-75% efficiency)."
  90. ),
  91. data_files=[
  92. "editing_efficiency.csv",
  93. "protein_knockout.png",
  94. "editing_percentages.png",
  95. "off_target_analysis.csv"
  96. ]
  97. ):
  98. if update["type"] == "text":
  99. print(update["content"], end="", flush=True)
  100. elif update["type"] == "progress":
  101. print(f"[{update['stage']}] {update['message']}")
  102. elif update["type"] == "result":
  103. print(f"✓ PDF: {update['files']['pdf_final']}")
  104. print(f" Figures: {len(update['files']['figures'])} included")
  105. asyncio.run(main())
  106. ```
  107. ## 🎯 Use as a Claude Code Plugin (Recommended)
  108. **Scientific Writer works best as a Claude Code (Cursor) plugin**, providing seamless access to all scientific writing capabilities directly in your IDE. No CLI required!
  109. ### Quick Start - Plugin Installation
  110. 1. **Add the plugin marketplace** in Claude Code:
  111. ```bash
  112. /plugin marketplace add https://github.com/K-Dense-AI/claude-scientific-writer
  113. ```
  114. 2. **Install the plugin**:
  115. ```bash
  116. /plugin install claude-scientific-writer
  117. ```
  118. 3. **Restart Claude Code** when prompted.
  119. 4. **Initialize in your project**:
  120. ```bash
  121. /claude-scientific-writer:scientific-writer-init
  122. ```
  123. This creates a `CLAUDE.md` file with comprehensive scientific writing instructions and makes all 26 selected skills available.
  124. 5. **Start using immediately**:
  125. ```bash
  126. # Create papers with data and figures
  127. > Create a Nature paper on CRISPR gene editing. Present knockout_efficiency.csv
  128. (5 cell lines tested), include Western blot (protein_levels.png) and flow
  129. cytometry data (editing_rates.png). Highlight 87% efficiency in HEK293 cells.
  130. > Write an NSF grant proposal for quantum computing. Present preliminary results
  131. from gate_fidelity.csv (99.2% fidelity), include circuit_diagram.png and
  132. error_analysis.png. Compare to state-of-art 95% baseline.
  133. > Generate conference poster. Feature results from clinical_trial.csv
  134. (n=150), survival_curves.png, biomarker_heatmap.png, and mechanism_diagram.svg.
  135. # Use specific skills with research data
  136. > @research-lookup Find papers on mRNA vaccine efficacy (2022-2024). Compare
  137. with our trial_data.csv showing 94% efficacy and antibody_titers.xlsx.
  138. > @peer-review Evaluate this manuscript. Reference sample size in methods.csv
  139. (n=30) and effect_sizes.png. Assess if statistical power is adequate.
  140. > @clinical-reports Create case report for autoimmune disorder. Include patient_labs.xlsx
  141. (6 months data), MRI_scans/ folder, treatment_timeline.csv showing response.
  142. ```
  143. ### Why Use the Plugin?
  144. - ✅ **No CLI Required** - Everything works directly in Claude Code
  145. - ✅ **Instant Access** - All 26 selected skills available immediately
  146. - ✅ **IDE Integration** - Files created and edited in your project
  147. - ✅ **Context Aware** - Skills understand your project structure
  148. - ✅ **Seamless Workflow** - No switching between tools
  149. ### Available Skills
  150. When installed as a plugin, you get instant access to a reproducible subset of [K-Dense-AI/scientific-agent-skills](https://github.com/K-Dense-AI/scientific-agent-skills), plus Anthropic's `docx`, `pdf`, `pptx`, and `xlsx` office skills from [anthropics/skills](https://github.com/anthropics/skills) (Apache License 2.0; see each skill's `LICENSE.txt`), all pinned in `skills.lock.json`. Background on the skills model is in [Agent Skills: The Final Piece for AI-Powered Scientific Research](https://www.k-dense.ai/blog/agent-skills-final-piece-for-ai-powered-research) and [K-Dense Web vs Scientific Agent Skills](https://www.k-dense.ai/blog/k-dense-web-vs-scientific-agent-skills). Read [Security in the Science Agent Era](https://www.k-dense.ai/blog/skill-security-before-you-install) before installing skills in a lab environment.
  151. - `scientific-schematics` - AI diagram generation with Nano Banana 2 (CONSORT, neural networks, pathways); see [Benchmarking Nano Banana 2 Lite for Scientific Image Generation](https://www.k-dense.ai/blog/benchmarking-nano-banana-2-lite-scientific-image-model)
  152. - `research-lookup` - Real-time literature search
  153. - `peer-review` - Systematic manuscript evaluation
  154. - `citation-management` - BibTeX and reference handling
  155. - `clinical-reports` - Medical documentation standards
  156. - `research-grants` - NSF, NIH, DOE proposal support
  157. - `scientific-slides` - Research presentations
  158. - `latex-posters` - Conference poster generation
  159. - `hypothesis-generation` - Scientific hypothesis development
  160. - `market-research-reports` - Comprehensive 50+ page market analysis reports with visuals
  161. - And 16 more specialized skills...
  162. For local plugin development and testing, see the [Development Guide](docs/DEVELOPMENT.md#plugin-development).
  163. ## Features
  164. ### 📝 Document Generation
  165. - **Scientific papers** with IMRaD structure (Nature, Science, NeurIPS, etc.)
  166. - **Clinical reports** (case reports, diagnostic reports, trial reports, patient documentation)
  167. - **Research posters** using LaTeX (beamerposter, tikzposter, baposter)
  168. - **Grant proposals** (NSF, NIH, DOE, DARPA) with agency-specific formatting
  169. - **Literature reviews** with systematic citation management
  170. - **Scientific schematics** powered by Nano Banana 2 (CONSORT diagrams, neural architectures, biological pathways, circuit diagrams) — [image-model benchmark](https://www.k-dense.ai/blog/benchmarking-nano-banana-2-lite-scientific-image-model)
  171. ### 🤖 AI-Powered Capabilities
  172. - **Real-time research lookup** powered by Parallel Search and Extract; why verification matters is covered in [The AI Co-Scientist Is Here. The Bottleneck Is Verification.](https://www.k-dense.ai/blog/ai-co-scientist-verification-bottleneck)
  173. - **AI-powered diagram generation** - create scientific diagrams from natural-language descriptions
  174. - **Intelligent paper detection** - automatically identifies references to existing papers
  175. - **Peer review feedback** with quantitative ScholarEval framework (8-dimension scoring)
  176. - **Iterative editing** with context-aware revision suggestions
  177. ### 🔧 Developer-Friendly
  178. - **Programmatic API** - Full async Python API with type hints
  179. - **CLI interface** - Interactive command-line tool with progress tracking
  180. - **Progress streaming** - Real-time updates during generation
  181. - **Comprehensive results** - JSON output with metadata, file paths, citations
  182. ### 📦 Data & File Integration
  183. - **Automatic data handling** - Drop files in `data/`, auto-sorted to `figures/` or `data/`
  184. - **Document conversion** - PDF, DOCX, PPTX, XLSX to Markdown with MarkItDown
  185. - **Bibliography management** - Automatic BibTeX generation and citation formatting
  186. - **Figure integration** - Images automatically referenced and organized
  187. ## Typical Workflow
  188. ### CLI Usage
  189. 1. Place figures and data in `data/` at the project root (images → `figures/`, files → `data/` automatically)
  190. 2. Run `scientific-writer` and describe what you want
  191. 3. Follow progress updates; outputs saved to `writing_outputs/<timestamp>_<topic>/`
  192. ```bash
  193. # Start a new paper with figures and data
  194. > Create a Nature paper on CRISPR gene editing. Include experimental_results.csv showing knockout efficiency across 5 cell lines. Reference figure1.png (Western blot) and figure2.png (flow cytometry data) in the results section. Discuss the 87% efficiency improvement observed in HEK293 cells.
  195. # Continue editing with additional research results
  196. > Add a methods section describing the experimental setup used to generate the data in results_table.csv. Reference the protocols for transfection, selection, and validation shown in microscopy_images/ folder.
  197. # Grant proposal with preliminary data
  198. > Write an NSF proposal for quantum computing research. Present preliminary results from quantum_fidelity.csv showing 99.2% gate fidelity. Include circuit_diagram.png and error_rates.png figures. Emphasize the breakthrough results compared to current state-of-art (95% fidelity).
  199. # Research poster with comprehensive figures
  200. > Generate a conference poster from my paper. Feature dose_response_graph.png as the central figure. Include mechanism_schematic.png, compare_treatments.png, and statistical_analysis.png. Highlight the p<0.001 significance for the primary outcome shown in the results.
  201. # Clinical case report with patient data
  202. > Create a clinical case report for rare disease presentation. Reference patient_timeline.csv showing symptom progression over 6 months. Include diagnostic_images/ (CT scans, MRI). Discuss lab_values.xlsx showing elevated biomarkers and treatment response documented in follow_up_data.csv.
  203. # Literature review with meta-analysis
  204. > Create a literature review on machine learning in healthcare. Reference the comparison in studies_comparison.csv covering 50 papers. Include forest_plot.png showing pooled effect sizes and quality_assessment.png from bias analysis. Synthesize the findings showing diagnostic accuracy (AUC 0.89), treatment prediction (accuracy 82%), and risk stratification results.
  205. ```
  206. ### API Usage
  207. ```python
  208. import asyncio
  209. from scientific_writer import generate_paper
  210. async def main():
  211. async for update in generate_paper(
  212. query="Create a NeurIPS paper on transformers",
  213. data_files=["results.csv", "figure.png"],
  214. output_dir="./my_papers",
  215. track_token_usage=True # Optional: track token consumption
  216. ):
  217. if update["type"] == "text":
  218. print(update["content"], end="", flush=True)
  219. elif update["type"] == "progress":
  220. print(f"[{update['stage']}] {update['message']}")
  221. elif update["type"] == "result":
  222. print(f"✓ PDF: {update['files']['pdf_final']}")
  223. # Token usage available when track_token_usage=True
  224. if "token_usage" in update:
  225. print(f" Tokens used: {update['token_usage']['total_tokens']:,}")
  226. asyncio.run(main())
  227. ```
  228. ## Quick Reference
  229. ### Common Commands
  230. | Task | Command Example |
  231. |------|----------------|
  232. | **Scientific Paper** | `> Create a Nature paper on CRISPR gene editing. Present knockout efficiency data from results.csv (5 cell lines tested). Include Western blot (figure1.png) and flow cytometry (figure2.png) showing 87% efficiency in HEK293 cells. Compare with published benchmarks.` |
  233. | **Clinical Report** | `> Create a clinical case report for rare mitochondrial disease. Include patient_timeline.csv (6-month progression), diagnostic_scans/ folder (MRI, CT images), and lab_values.xlsx showing elevated lactate (8.2 mmol/L) and creatine kinase (450 U/L). Describe treatment response.` |
  234. | **Grant Proposal** | `> Write an NSF proposal for quantum error correction research. Present preliminary data from gate_fidelity.csv showing 99.2% fidelity (vs 95% state-of-art). Include circuit_topology.png, error_rates_comparison.png, and scalability_projections.csv for 100-qubit systems.` |
  235. | **Research Poster** | `> Generate an A0 conference poster. Highlight findings from efficacy_study.csv (n=150 patients, 40% response rate). Feature mechanism_diagram.png, survival_curves.png, biomarker_heatmap.png, and statistical_forest_plot.png (p<0.001 primary endpoint).` |
  236. | **Literature Review** | `> Create a systematic review on AI in drug discovery. Reference studies_database.csv (127 papers, 2020-2024). Include success_rates_meta.png (pooled OR=2.3, 95% CI 1.8-2.9), publication_trends.png, and therapeutic_areas_breakdown.csv showing oncology dominance (45% of studies).` |
  237. | **Peer Review** | `> Evaluate this manuscript using ScholarEval. Reference figures (power_analysis.png shows n=30, underpowered), review statistics in results_table.csv, assess methodology against CONSORT standards, verify citations match claims.` |
  238. | **Hypothesis Paper** | `> Generate research hypotheses on aging interventions. Reference transcriptomics_data.csv (15,000 genes across tissues), pathway_enrichment.png, and longevity_correlations.csv. Propose 5 testable hypotheses linking NAD+ metabolism, senescence, and lifespan extension.` |
  239. | **Continue Editing** | `> Add methods section describing the protocols used to generate binding_assay.csv data. Include equipment specs, statistical tests used (t-tests in stats_summary.csv), and sample size justification from power_calculation.xlsx` |
  240. | **Find Existing Paper** | `> Find the CRISPR paper and add discussion of limitations shown in off_target_analysis.csv and efficiency_variation.png across different cell types` |
  241. ### Research Lookup Examples
  242. ```bash
  243. # Recent research with data integration (auto-triggers research lookup)
  244. > Create a paper on recent advances in quantum computing (2024). Compare published values with our gate_fidelity_results.csv (99.2% for 2-qubit gates). Include our error_correction_benchmarks.png and cite papers achieving >98% fidelity.
  245. # Fact verification with experimental context
  246. > What are the current success rates for CAR-T therapy in B-cell lymphoma? Compare with our clinical_trial_outcomes.csv (n=45 patients, 62% complete response). How do our results compare to published JULIET and ZUMA trials?
  247. ```
  248. ### File Handling
  249. ```bash
  250. # 1. Drop all your research files in the data/ folder at the project root
  251. cp experimental_data.csv western_blot.png statistical_summary.xlsx ~/Documents/claude-scientific-writer/data/
  252. # 2. Files are automatically sorted by type:
  253. # Images (png, jpg, svg, tif, pdf figures) → figures/
  254. # Data files (csv, json, txt, xlsx, tsv) → data/
  255. # Documents (pdf, docx, pptx) → converted to markdown
  256. # 3. Reference files (or whole folders) explicitly in your prompt with specific details
  257. > Create a NeurIPS paper on deep learning optimization. Include training_curves.csv showing convergence after 50 epochs, accuracy_comparison.png (our method: 94.2% vs baseline: 89.1%), and architecture_diagram.svg in methods.
  258. ```
  259. For more extensive API examples (multiple data files, clinical trial reports, token tracking), see the [API Reference](docs/API.md).
  260. ## Plugin Testing (Local Development)
  261. For developers working on the plugin or testing it locally, see the [Development Guide](docs/DEVELOPMENT.md#plugin-development), which covers setting up a local test marketplace, installing the plugin from a local checkout, verifying the plugin structure, and troubleshooting installation issues.
  262. ## 📄 Example Outputs
  263. Want to see what Scientific Writer can create? Check out real examples in the [`docs/examples/`](docs/examples/) directory!
  264. | Document Type | Example | Description |
  265. |--------------|---------|-------------|
  266. | **Research Paper** | Coming soon | Full scientific papers with IMRaD structure |
  267. | **Grant Proposal** | [NSF Proposal](docs/examples/grants/NSF_draft1.pdf) | Complete NSF grant with budget and timeline |
  268. | **Research Poster** | [Conference Poster](docs/examples/poster/poster.pdf) | LaTeX-generated academic poster |
  269. | **Presentation Slides** | [AI Scientist Talk](docs/examples/slides/ai_scientist_talk.pdf) | Professional research presentation |
  270. | **Clinical Report** | [Treatment Plan](docs/examples/treatment_plan/GERD.pdf) | Patient treatment documentation |
  271. | **Clinical Decision Support** | [Breast Cancer](docs/examples/clinical_decision_support/breast_cancer.pdf) | Evidence-based clinical recommendations |
  272. | **Hypothesis Generation** | [AI Weather Prediction](docs/examples/hypotheses_generation/AI_in_weather.pdf) | Research hypothesis development |
  273. | **Market Research** | [Agentic AI Report](docs/examples/market%20research%20reports/agentic_ai_life_sciences.pdf) | Industry analysis and market insights |
  274. **🎯 Browse the examples** to see formatting, structure, and quality before starting your own projects!
  275. ## Documentation
  276. ### User Guides
  277. - [📖 Complete Features Guide](docs/FEATURES.md) - Comprehensive overview of all capabilities
  278. - [🔧 API Reference](docs/API.md) - Full programmatic API documentation
  279. - [🎯 Skills Overview](docs/SKILLS.md) - All available skills and tools
  280. - [🐛 Troubleshooting](docs/TROUBLESHOOTING.md) - Common issues and solutions
  281. - [📰 From the K-Dense Blog](#from-the-k-dense-blog) - Related posts on writing, skills, citations, grants, and the hosted sibling product
  282. ### Developer Resources
  283. - [🤝 Contributing Guide](CONTRIBUTING.md) - Dev setup, tests, and PR guidelines
  284. - [💻 Development Guide](docs/DEVELOPMENT.md) - Architecture and plugin development
  285. - [🛠️ Skill Authoring Guide](docs/SKILL_AUTHORING.md) - How to write and register a new skill
  286. - [📦 Releasing Guide](docs/RELEASING.md) - Versioning and publishing
  287. - [📋 Release Notes](CHANGELOG.md) - Version history and updates
  288. - [🔌 Agent Plugins Support](docs/AGENT_PLUGINS.md) - Using and validating this repo as a portable Agent Plugin
  289. - [🤖 System Instructions](CLAUDE.md) - Agent instructions (advanced), mirrored to [AGENTS.md](AGENTS.md)
  290. - [📝 Zotero DOCX Extension](extensions/docx-editor-zotero/README.md) - Optional citation-preserving Word workflow
  291. ## From the K-Dense Blog
  292. Tutorials, comparisons, and research notes from the [K-Dense blog](https://www.k-dense.ai/blog) that relate to this repository. The hosted product that includes a deeper version of this writing engine is [K-Dense Web](https://www.k-dense.ai).
  293. ### This tool
  294. | Post | Why it is relevant |
  295. |------|-------------------|
  296. | [Claude Scientific Writer: Our Open Source Tool for AI-Powered Research Writing](https://www.k-dense.ai/blog/claude-scientific-writer-open-source) | Announcement: research-first writing, venue-specific outputs, data/figure integration, and MIT license |
  297. | [K-Dense Web vs Scientific Agent Skills: Why We Built Both](https://www.k-dense.ai/blog/k-dense-web-vs-scientific-agent-skills) | When to use this open-source plugin versus the hosted platform |
  298. | [K-Dense Web vs Claude Code: Different Tools for Different Jobs](https://www.k-dense.ai/blog/k-dense-web-vs-claude-code) | How the Claude Code plugin fits next to the hosted multi-agent product |
  299. | [Your AI Assistant Reasons Like a Generalist. Science Needs a Specialist.](https://www.k-dense.ai/blog/introducing-scientific-agents) | Places Scientific Writer in the broader open-source science-agent stack |
  300. ### Skills, figures, and other agents
  301. | Post | Why it is relevant |
  302. |------|-------------------|
  303. | [Agent Skills: The Final Piece for AI-Powered Scientific Research](https://www.k-dense.ai/blog/agent-skills-final-piece-for-ai-powered-research) | The skills model behind the plugin (`scientific-schematics`, `research-lookup`, grants, posters, and the rest) |
  304. | [Security in the Science Agent Era: What Every Lab Needs to Know Before Installing Skills](https://www.k-dense.ai/blog/skill-security-before-you-install) | Prompt-injection, poisoned `SKILL.md` files, auditing, and version pinning |
  305. | [Benchmarking Nano Banana 2 Lite for Scientific Image Generation](https://www.k-dense.ai/blog/benchmarking-nano-banana-2-lite-scientific-image-model) | Figure-generation quality for schematics, slides, and infographics |
  306. | [How to Use Multica for Scientific Research](https://www.k-dense.ai/blog/multica-scientific-research) | Loading scientific-writing, literature-review, and related skills in another Agent Skills host |
  307. | [The Sandboxed AI Scientist: Pairing NVIDIA OpenShell with Scientific Agent Skills](https://www.k-dense.ai/blog/sandboxed-ai-scientist-openshell-skills) | Running skills in a policy-governed sandbox |
  308. ### Research, citations, and writing quality
  309. | Post | Why it is relevant |
  310. |------|-------------------|
  311. | [The AI Co-Scientist Is Here. The Bottleneck Is Verification.](https://www.k-dense.ai/blog/ai-co-scientist-verification-bottleneck) | Why this tool researches and verifies before it writes |
  312. | [Reproduction, Not Generation, Is AI's Killer App for Science](https://www.k-dense.ai/blog/reproduction-not-generation-ai-for-science) | Auditable, checkable outputs rather than unchecked generation |
  313. | [K-Dense Web vs ChatGPT: Why Traditional AI Assistants Fall Short for Research](https://www.k-dense.ai/blog/k-dense-web-vs-chatgpt) | Research-backed writing versus conversational drafting |
  314. | [K-Dense Web vs OpenAI Prism: Task Execution vs Writing Assistance](https://www.k-dense.ai/blog/k-dense-web-vs-openai-prism) | Execution-plus-writing versus a writing-only assistant |
  315. | [Guide to Prompting K-Dense Web: Get Better Results in Minutes](https://www.k-dense.ai/blog/guide-to-prompting-k-dense-web) | Prompt patterns that transfer to the CLI, API, and plugin |
  316. ### Grants, proposals, and long-form reports
  317. | Post | Why it is relevant |
  318. |------|-------------------|
  319. | [From Blank Page to Research Roadmap: How AI Helps Define New Scientific Directions](https://www.k-dense.ai/blog/ai-research-direction-discovery-phd-proposal) | Literature synthesis and a 26-page PhD-style proposal |
  320. | [Catalyzing Breakthroughs: A 42-Page ARPA-H Policy Report, Generated in One Session](https://www.k-dense.ai/blog/arpa-h-policy-report-analysis) | Long-form report with figures and verified citations |
  321. ### Hosted sibling and FAQ
  322. | Post | Why it is relevant |
  323. |------|-------------------|
  324. | [Introducing K-Dense Web: Research. Analyze. Synthesize.](https://www.k-dense.ai/blog/introducing-k-dense-web) | The hosted product for end-to-end research plus writing |
  325. | [AI Co-Scientists, Answered: 20 Questions from a Live Session](https://www.k-dense.ai/blog/ai-co-scientists-answered-20-questions) | What the stack does today, and where it still falls short |
  326. | [K-Dense Web vs. Claude Science](https://www.k-dense.ai/blog/k-dense-web-vs-claude-science) | Execution and scientific-quality scores on 20 research tasks |
  327. Browse every post at [www.k-dense.ai/blog](https://www.k-dense.ai/blog).
  328. ## Use with Antigravity, Pi, and Other Agents
  329. This repository is a conformant [Agent Plugins](https://agent-plugins.org/) 1.0.0 package, the
  330. vendor-neutral standard for packaging [Agent Skills](https://agentskills.io/specification) and MCP
  331. servers. Its skills follow the Agent Skills format, so they load in Claude Code and in any other
  332. Agent Plugins client without modification.
  333. ### Agent Plugins clients (recommended)
  334. Point your client at any of these plugin roots — each has a `plugin.json` manifest and a `skills/`
  335. directory:
  336. ```bash
  337. # From a checkout
  338. git clone https://github.com/K-Dense-AI/claude-scientific-writer.git
  339. # Or from the published package — the installed payload is a plugin root too
  340. pip install scientific-writer
  341. python -c "import scientific_writer, pathlib; print(pathlib.Path(scientific_writer.__file__).parent / '.claude')"
  342. ```
  343. Project instructions are available under both filenames: `CLAUDE.md` and the byte-identical
  344. `AGENTS.md`. Running `/claude-scientific-writer:scientific-writer-init` writes both into your
  345. project, and the CLI reads instructions from `.claude/` or `.agents/` — see
  346. [docs/AGENT_PLUGINS.md](docs/AGENT_PLUGINS.md) for the full lookup order and how to validate a plugin
  347. root with `scripts/validate_agent_plugin.py`.
  348. ### Manual approach
  349. For an agent that does not load Agent Plugins packages (Antigravity, Pi, Aider, Continue, etc.), load a single skill by hand. A worked example of importing scientific-writing and literature-review skills into another host is [How to Use Multica for Scientific Research](https://www.k-dense.ai/blog/multica-scientific-research).
  350. 1. Open the relevant `skills/<skill-name>/SKILL.md` file.
  351. 2. Copy the content below the YAML frontmatter (everything after the closing `---`).
  352. 3. Paste it into your agent's system prompt, custom instructions file, or equivalent configuration.
  353. Most agents read `AGENTS.md` from the project root, so appending the skill body there is usually enough:
  354. ```bash
  355. # Append the scientific-writing skill (frontmatter stripped) to the project's AGENTS.md
  356. awk 'f; /^---$/ && NR>1 {f=1}' skills/scientific-writing/SKILL.md >> AGENTS.md
  357. ```
  358. ### Claude Code-specific features
  359. The following SKILL.md frontmatter fields are Claude Code-specific and can be safely ignored by other agents:
  360. | Field | Claude Code behaviour | Other agents |
  361. |-------|-----------------------|--------------|
  362. | `allowed-tools` | Restricts which tools the agent may call; written as a space-separated string (e.g. `allowed-tools: Read Write Edit Bash`) | Ignore or map to your agent's tool-permission system |
  363. | `hooks` | Runs shell commands before/after skill execution | Ignore or implement equivalent pre/post hooks manually |
  364. | `version` | Used by Claude Code marketplace | Informational only |
  365. All skill *content* (instructions, workflows, code examples) is agent-agnostic and works with any sufficiently capable LLM.
  366. ## Versioning and Publishing (short)
  367. Use `uv` and the helper scripts:
  368. - Bump version (keeps pyproject + __init__ in sync): `uv run scripts/bump_version.py [patch|minor|major]`
  369. - Build and publish: `uv run scripts/publish.py` (or `--bump patch|minor|major`)
  370. See [docs/RELEASING.md](docs/RELEASING.md) for prerequisites, dry runs, tagging, and verification.
  371. ## Migration
  372. ### v1.x -> v2.0
  373. - CLI remains unchanged (scientific-writer).
  374. - New programmatic API: from scientific_writer import generate_paper.
  375. - Legacy single-file script is replaced by a proper package; no action needed for CLI users.
  376. ### Research backend (v2.13+)
  377. - Research lookup, web search, and deep research use Parallel Search, Extract, and Research through `parallel-cli`. Authenticate with `parallel-cli login` or set `PARALLEL_API_KEY`.
  378. - `OPENROUTER_API_KEY` is not used by the default research path. It remains optional for image-generation skills and explicitly requested Perplexity fallback research.
  379. ## License
  380. MIT - see LICENSE.
  381. ## Support
  382. - Open an issue on GitHub
  383. - See [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) for common problems
  384. - Read related walkthroughs on the [K-Dense blog](https://www.k-dense.ai/blog)
  385. ## 💬 Join Our Community!
  386. **Follow us for updates:** [Blog](https://www.k-dense.ai/blog) · [X](https://x.com/k_dense_ai) · [LinkedIn](https://www.linkedin.com/company/k-dense-inc) · [YouTube](https://www.youtube.com/@K-Dense-Inc)
  387. **Want to connect with other researchers, share tips, and get help in real-time?** Join our vibrant Slack community! 🎉
  388. Whether you're writing your first paper, exploring advanced features, or just want to chat about scientific writing and AI, we'd love to have you! Get faster support, share your success stories, and collaborate with fellow users.
  389. 👉 **[Join the K-Dense Community on Slack](https://join.slack.com/t/k-densecommunity/shared_invite/zt-3iajtyls1-EwmkwIZk0g_o74311Tkf5g)** 👈
  390. We're excited to meet you! 🚀
  391. ## ⭐ Show Your Support
  392. If you find this project helpful for your research or work, please consider giving it a star on GitHub! It helps others discover the tool and motivates continued development. Thank you! 🙏
  393. ![GitHub stars](https://img.shields.io/github/stars/K-Dense-AI/claude-scientific-writer?style=social)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.