foryourhealth111-pixel/Vibe-Skills / bundled/skills/manuscript-as-code
manuscript-as-code
VerifiedTreat 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.
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
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |