paper2anything

English | 简体中文

Showcase · Installation · Usage · Output locations · Directory structure · Contributors · Acknowledgements

A skills pack that turns an academic paper PDF into any of several promotional artifacts, covering the main forms of paper dissemination:

Each subdirectory is an independent, auto-triggerable skill (each has its own SKILL.md).

Showcase

paper2slides

A sample of paper2slides output — eight decks across diverse research fields (HCI / VR, computer vision, drug discovery, security & provenance, multimodal agents, quantum computing, optimization, and ML theory):

paper2poster

A sample of paper2poster output — nine posters, spanning nine research fields (drug design, graphics, HCI, materials science, X-ray inspection, NLP / LLM safety, optics & photonics, statistical ML, and computer vision):

Installation

One-command install with Claude Code (recommended):

bash tools/install-linux.sh --create-env --shell-init     # Linux
bash tools/install-macos.sh --create-env --shell-init     # macOS

The install script will: ① symlink the 5 skills into ~/.claude/skills/; ② bootstrap a .env from .env.example if you don't have one; ③ check the conda environment, system dependencies, and MINERU_API_TOKEN (used for paper extraction). What the two flags do (omit them if you don't need them):

• --create-env: conda env create (updates per environment.yml if it already exists) + installs playwright chromium + runs a pip self-check;
• --shell-init: (optional) writes the .env auto-export into your shell startup file, so a new shell loads the credentials automatically.

After it runs, follow the script's prompts for two more steps:

1. Fill in MINERU_API_TOKEN in .env (required);
2. Install the missing system-level dependencies it points out (the script detects each one and gives the install command).

If you need to install manually (e.g. you only use one specific skill), here is the equivalent breakdown.

Register a skill

Symlink the skills you want into ~/.claude/skills/ so Claude Code can discover and auto-trigger them:

# From the paper2anything package root; copy the line for whichever skill you want
mkdir -p ~/.claude/skills
ln -sfn "$(pwd)/paper2slides"  ~/.claude/skills/paper2slides
ln -sfn "$(pwd)/paper2poster"  ~/.claude/skills/paper2poster
ln -sfn "$(pwd)/paper2html"    ~/.claude/skills/paper2html
ln -sfn "$(pwd)/paper2xhs"     ~/.claude/skills/paper2xhs
ln -sfn "$(pwd)/paper2wechat"  ~/.claude/skills/paper2wechat

conda environment

All 5 skills share one conda environment, paper2anything.

# From the paper2anything package root
conda env create -f environment.yml
conda activate paper2anything

System-level dependencies

Node.js (Linux): sharp requires Node ≥20.9.0; install it via NodeSource:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt install -y nodejs

Credentials

All skills' credentials live in a single .env at the package root (copy from .env.example and fill it in). After copying, just fill in your keys:

cp .env.example .env          # first time: copy, then fill in your keys

Optional: write the .env export into your shell startup file. Pass --shell-init during install to do this automatically (see Installation), or add this line manually:

set -a; source <paper2anything package root>/.env; set +a

Usage

Just state your intent and the matching skill auto-triggers, e.g.:

• "make path/to/paper.pdf into slides" → paper2slides
• "make a conference poster from this paper" → paper2poster
• "turn this PDF into a project homepage" → paper2html
• "post this paper to Xiaohongshu for me" → paper2xhs
• "write this paper as a WeChat article" → paper2wechat

Or call them explicitly with a slash command, followed by the PDF path:

/paper2slides path/to/paper.pdf
/paper2poster path/to/paper.pdf
/paper2html   path/to/paper.pdf
/paper2xhs    path/to/paper.pdf
/paper2wechat path/to/paper.pdf

Output locations

Each skill's final deliverable lands in the same directory as the paper; all intermediate artifacts are kept under .paper2anything/<skill>/<paper-name>/ in that same directory:

Directory structure

paper2anything/
├── environment.yml          # python environment
├── .env.example             # credentials template (copy to .env and fill in)
├── .gitignore               # ignores .env / __pycache__ etc.
├── LICENSE                  # Apache-2.0
├── README.md                # this file (English, default)
├── README.zh-CN.md          # Chinese version
├── tools/                   # install scripts
├── assets/                  # static files
│   └── showcase/            # per-skill output samples (assets/showcase/<skill>/)
├── paper2slides/            # paper → slides
│   ├── SKILL.md
│   ├── references/          # design style, outline heuristics, pipeline, schema, pptxgenjs
│   └── scripts/             # parse_pdf / render_pptx / page_screenshot / workdir + lib/
├── paper2poster/            # paper → poster HTML/PNG
│   ├── SKILL.md
│   ├── references/          # poster examples, color palettes, layout guide
│   └── scripts/             # parse_pdf / auto_outline / geom_check / collect_figures / screenshot / check_env
├── paper2html/              # paper → single-page project homepage
│   ├── SKILL.md
│   ├── references/          # design languages, HTML authoring spec, QA checklist
│   └── scripts/             # parse_pdf / validate / render_check etc. + lib/ (parse/extract/QA, no renderer)
├── paper2xhs/               # paper → Xiaohongshu
│   ├── SKILL.md
│   ├── references/          # publish guide
│   └── scripts/             # parse_pdf / cover / publish / xhs_login + utils
└── paper2wechat/            # paper → WeChat
    ├── SKILL.md
    └── scripts/             # parse_pdf / cover / publish + utils

Contributors

Skill design leads at the AI4GC Lab: