manuscript-as-code

Treat manuscripts as software: version control, reproducible builds, figure pipelines, CI, and structured repo layout. Helps teams avoid 'final_v7' chaos and ensures submission-ready artifacts.

Best use case

manuscript-as-code is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Treat manuscripts as software: version control, reproducible builds, figure pipelines, CI, and structured repo layout. Helps teams avoid 'final_v7' chaos and ensures submission-ready artifacts.

Teams using manuscript-as-code should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/manuscript-as-code/SKILL.md --create-dirs "https://raw.githubusercontent.com/foryourhealth111-pixel/Vibe-Skills/main/bundled/skills/manuscript-as-code/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/manuscript-as-code/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How manuscript-as-code Compares

Feature / Agentmanuscript-as-codeStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Treat manuscripts as software: version control, reproducible builds, figure pipelines, CI, and structured repo layout. Helps teams avoid 'final_v7' chaos and ensures submission-ready artifacts.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# Manuscript as Code(论文工程化)

## 目标

把“写论文”升级成“交付可复现的出版工程”:
- 结构清晰:任何人进仓库都知道哪里改正文、哪里改图、哪里改引用
- 可复现:一条命令能构建 PDF/HTML;CI 自动验证
- 可审计:每张图/每个结果都有来源(代码/数据/参数)

适用:
- 多人协作写作(导师/合作者/跨机构)
- 反复投稿/返修(需要明确改动轨迹)
- 图表多、实验多、容易“找不到版本”的项目

---

## 推荐仓库结构(最小可行)

见 `templates/repo-structure.md`。核心思想:
- `manuscript/`:只放正文与引用(source-of-truth)
- `figures/`:每张图一个目录(source + out)
- `build/`:所有生成物(可删除,可再生)
- `submission/` 与 `revision/`:投稿与返修阶段产物

---

## 元规则(工程化的关键)

### 1) 生成物与源文件分离

- 源:`figures/fig-02/src/plot.py`
- 产物:`figures/fig-02/out/fig-02.pdf`
- 禁止把产物当源文件编辑(比如在 PDF 上涂改)

### 2) 每张图都要能“重生成”

最少要求:
- 一条命令 + 固定参数能导出最终图(PDF/TIFF)
- 记录依赖版本与随机种子(如果有)

### 3) 把“投稿约束”写成配置

推荐维护:
- `submission/submission-manifest.yml`(统一记录规格与完成度)

---

## 案例(推荐学习)

- Manubot:`manubot/rootstock`(论文的 CI/协作写作范式)
- Deep review:`greenelab/deep-review`(评审/返修视角)

Related Skills

zinc-database

1174
from foryourhealth111-pixel/Vibe-Skills

Access ZINC (230M+ purchasable compounds). Search by ZINC ID/SMILES, similarity searches, 3D-ready structures for docking, analog discovery, for virtual screening and drug discovery.

zarr-python

1174
from foryourhealth111-pixel/Vibe-Skills

Chunked N-D arrays for cloud storage. Compressed arrays, parallel I/O, S3/GCS integration, NumPy/Dask/Xarray compatible, for large-scale scientific computing pipelines.

yeet

1174
from foryourhealth111-pixel/Vibe-Skills

Use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one flow using the GitHub CLI (`gh`).

xlsx

1174
from foryourhealth111-pixel/Vibe-Skills

Spreadsheet toolkit (.xlsx/.csv). Create/edit with formulas/formatting, analyze data, visualization, recalculate formulas, for spreadsheet processing and analysis.

xan

1174
from foryourhealth111-pixel/Vibe-Skills

High-performance CSV processing with xan CLI for large tabular datasets, streaming transformations, and low-memory pipelines.

writing-plans

1174
from foryourhealth111-pixel/Vibe-Skills

Use when you have a spec or requirements for a multi-step task, before touching code

writing-docs

1174
from foryourhealth111-pixel/Vibe-Skills

Guides for writing and editing Remotion documentation. Use when adding docs pages, editing MDX files in packages/docs, or writing documentation content.

windows-hook-debugging

1174
from foryourhealth111-pixel/Vibe-Skills

Windows环境下Claude Code插件Hook执行错误的诊断与修复。当遇到hook error、cannot execute binary file、.sh regex误匹配、WSL/Git Bash冲突时使用。

weights-and-biases

1174
from foryourhealth111-pixel/Vibe-Skills

Track ML experiments with automatic logging, visualize training in real-time, optimize hyperparameters with sweeps, and manage model registry with W&B - collaborative MLOps platform

webthinker-deep-research

1174
from foryourhealth111-pixel/Vibe-Skills

Deep web research for VCO: multi-hop search+browse+extract with an auditable action trace and a structured report (WebThinker-style).

vscode-release-notes-writer

1174
from foryourhealth111-pixel/Vibe-Skills

Guidelines for writing and reviewing Insiders and Stable release notes for Visual Studio Code.

visualization-best-practices

1174
from foryourhealth111-pixel/Vibe-Skills

Visualization Best Practices - Auto-activating skill for Data Analytics. Triggers on: visualization best practices, visualization best practices Part of the Data Analytics skill category.