Skip to content
cccskills
FreePublished on GitHub

manuscript-as-code

Organize manuscript text, figures, and references with version control and repeatable builds. Track how each figure was produced, separate source files from generated outputs, and use automated checks to prepare submission artifacts.

OriginalShow the original description

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.

See how to install

Good for

  • Organizing files for collaborative manuscript writing
  • Tracking changes across submissions and revisions
  • Reproducing figures from code, data, and fixed parameters
  • Setting up repeatable PDF or HTML builds

Files included (2)

  • SKILL.md1.8 KB
  • templates/repo-structure.md856 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

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(评审/返修视角)

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

adaptyv

FreeSummary

Support experimental validation of designed proteins through a cloud laboratory. Prepare and optimize sequences, submit tests for binding, expression, thermal stability, or enzyme activity, track experiment progress, and retrieve results through the API.

  • Submit designed proteins for binding tests
  • Request expression, thermal stability, or enzyme activity tests
  • Optimize sequences for solubility before experiments
foryourhealth111-pixel/Vibe-Skills3.8KUpdated Oct 23, 2026

aeon

FreeSummary

Analyze time series, observations ordered over time, using aeon in Python. Build classification, prediction, and clustering workflows, detect unusual patterns or changes, and compare methods through an interface compatible with scikit-learn.

  • Classifying time series by their patterns
  • Forecasting future values from past observations
  • Detecting anomalies and change points
foryourhealth111-pixel/Vibe-Skills3.8KUpdated Oct 23, 2026

algorithmic-art

FreeSummary

Create original generative art with p5.js, using code to produce patterns and motion. Receive a written artistic concept and an interactive HTML viewer with adjustable parameters, reproducible random variations, seed navigation, and PNG downloads.

  • Create art from particle motion and flow fields
  • Explore patterns by adjusting sliders
  • Reproduce a favorite variation with the same seed
foryourhealth111-pixel/Vibe-Skills3.8KUpdated Oct 23, 2026

alpha-vantage

FreeSummary

Retrieve stock prices, exchange rates, cryptocurrency prices, company financial statements, and economic indicators through the Alpha Vantage API. It also covers historical data, news sentiment, and technical indicators, which summarize price and trading patterns.

  • Retrieve historical stock prices and trading volumes
  • Collect company financial statements and earnings data
  • Check foreign exchange and cryptocurrency prices
foryourhealth111-pixel/Vibe-Skills3.8KUpdated Oct 23, 2026

Design backend systems with clear boundaries between business rules, databases, and external services. Use Clean Architecture, Hexagonal Architecture, and Domain-Driven Design to organize new applications, refactor existing code, and make core logic easier to test.

  • Planning the structure of a new backend
  • Refactoring tightly coupled applications
  • Testing business rules independently of external services
foryourhealth111-pixel/Vibe-Skills3.8KUpdated Oct 23, 2026

astropy

FreeSummary

Helps process astronomical data in Python by converting coordinates, units, and time scales, working with FITS observation files, matching object catalogs, and calculating distances using cosmological models.

  • Converting celestial coordinates
  • Reading and editing FITS observation files
  • Matching objects across astronomical catalogs
foryourhealth111-pixel/Vibe-Skills3.8KUpdated Oct 23, 2026

See all skills by foryourhealth111-pixel

Report a problem with this skill